/arktools

Command line tool which will create customized Game.ini and GameUserSettings.ini lines for the game Ark

Primary LanguageRubyMIT LicenseMIT

ArkTools

Copyright 2017 Donovan C. Young

Welcome to ArkTools!

Currently this provides a command line tool named arktool which will create customized Game.ini and GameUserSettings.ini lines for you.

Installation

Install the gem from rubygems as you normally would. Once installed, you'll have access to the command line tool named arktool.

$ gem install ArkTools

Usage

arktool help should get you started. Subcommands also have their own help, so arktool mods help will give you information about the mods subcommand.

Global Options

--verbose : displays information to the screen
--gamedir : When provided, we'll read any Game.ini and GameUserSettings.ini
            files in this directory.
--write   : Write output to Game.ini and/or GameUserSettings.ini file
            Uses `gamedir` if provided, otherwise the current directory.

Commands

Mods

These commands take an input file (via --file) in the following format:

MODID Description

Each mod should be separated on it's own line and the order of the lines determine the load order (top to bottom)

e.g.

776464863 Ragnarok
813220452 Ragnarok Lore

Levels

These commands will create customized level lists for your Game.ini. Please see arktool levels help for additional information.

--level       : the Maximum level for your server (required)
--exp         : The total experience to obtain max level (optional)
--growth      : a customized logarithmic "growth rate" (very optional -- if you don't know what this means, you probably don't need it)
--engrams [N] : Creates customized engram point lines as well, using N as the total
                number of engrams to award (optional, default is 5000)

Future Plans

  • Web based interface (for the non-ruby world)
  • Other configuration options / commands as requested by the community

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub.

License

This software is licensed under the MIT License, basically stating you can use it however you feel fit as long as you credit the original author (me). Please see the LICENSE file for additional information.