NorbiPeti
/
extracommands
forked from ExtraCommands/ExtraCommands
Watch 1
Star 0
Fork 0
Code Issues 0 Pull Requests 0 Releases 0 Wiki Activity
Moar Gamecraft commands!
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
30 Commits
2 Branches
788KB
Branch: master
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'master'
${ noResults }
NorbiPeti b3a72516fb
Add ClearConsole command 		4 years ago
extracommands Add ClearConsole command 4 years ago
.gitattributes Reimplement Waypoint functionality 5 years ago
.gitignore Add move blocks command and improve dependencies 5 years ago
ExtraCommands.sln Copy structure from TestMod base 5 years ago
IllusionPlugin.dll Add move blocks command and improve dependencies 5 years ago
LICENSE Initial commit 5 years ago
README.md Improve documentation with examples 5 years ago

README.md

ExtraCommands

Proof of concept mod and reference implementation

Installation

  1. Patch Gamecraft with GCIPA. You should download the latest release and extract it to the Gamecraft folder. To patch, drag Gamecraft.exe onto IPA.exe. You will need to redo this step whenever Gamecraft is updated.
  2. Extract the ExtraCommands zip into Gamecraft's Plugins\ folder (GCIPA should have created this automatically in the previous step). You should see 0Harmony.dll and ExtraCommands.dll in the Plugins\ folder. If those files are in another folder in Plugins\ it will not work.
  3. Launch Gamecraft. You can check the log file %APPDATA%\..\LocalLow\FreeJam\Gamecraft\Player.log to confirm. You should be able to see a message near the top showing how many plugins have been loaded and their names.

Development

Interested in adding your own commands? Clone this repository and create a C# class file in extracommands\. A template command is provided in ExampleCommandEngine.cs which you can copy to get started. It's recommended that you create a symbolic link named ref in the root directory of this project linked to the folder containing Gamecraft .dll files.

Testing

Patch Gamecraft with GCIPA. Create a symbolic link named ref in the root directory of this project linked to the folder containing Gamecraft .dll files (to resolve dependencies). Build the solution and copy bin\Debug\net45\extracommands.dll and bin\Debug\net45\0Harmony.dll into Gamecraft's Plugins\ folder. Load a game and try out your command in the command line interface in Gamecraft.

External Documentation

More information about the IPlugin and IEnhancedPlugin interface can be found on the IPA repository.

More information about Harmony can be found on the Harmony wiki.