Using the Minecraft Command Console
From CyberWurx Customer Wiki
Minecraft Command Console is a simple way to run basic commands on the console of the game and preform other basic tasks not available to a user with standard FTP access. It is a simple script that runs every minute. This guide is designed to teach you how to utilize this tool to your benefit.
Urgent news
Version 0.24 out! Added bukkit installer.
Configuration
Minecraft command console is disabled by default. If you would like to use this exciting new feature, you will need to configure it.
Simply open the file: console.cfg
Add your email after email= :
- Example
email=myemail@host.com
Properly Using the Command Console
The script will take each of your commands one by one (line by line) and run them. It is very important to use the proper syntax for commands, or they will not run properly. Once the commands run, the command list will automatically clear itself out.
- Refer back to this document for information regarding the command console.
Command Syntax
We are going to use a string of commands for an example here. I want to use several commands before I turn off my server to make sure it was properly saved. I could also do an emergency backup in case I want to download a quick world file.
To do this, you would simply open the commands.txt file in the root directory ( / ) of ftp. If you do not see a commands.txt, simply create one and upload it (it should be there already). When you have commands.txt open, simply add each command you want to run line by line. Here is an example of an emergency backup and server shutdown (this is useful for updating minecraft).
Here is how you do it:
save-all emergency-backup stop
These three commands will be taken and interpreted by the command console script one by one. A report of the commands will be emailed to you.
Available Commands
For a full list of available commands, see Minecraft Console Command List
Development commands may be shown here, but not available to your version. (Development commands will be featured here so you can prepare to use them) If you would like to see your current version, run the "about" command.
Script version 0.1
about
- Displays information about the script
reload
- This will reload Hey0's mod.
This is useful for installing new plugins or reloading a whitelist.
emergency-backup
- This will run the backup script on demand.
stop
- This command will stop the server.
If you are concerned about hard stopping your server via the game panel, run this first
save-all
- This will save the current world file completely.
save-off
- This will turn off world saving.
Make sure you turn it back on if you want to continue saving your world progress!
save-on
- This will turn on world saving.
Script version 0.15
Changelog:
Added new function Fixed a few typos
update
- Saves, stops, and downloads a new minecraft_server.jar file
Script version 0.16
Changelog:
Added new function updatescripts Fixed a bug that caused the console.cfg file to reset every minute
updatescripts
- This will update the backend scripts that are used to run the server.
You can find any major bugfixes on the Script Changelog
Recent changes to script structure made this command obsolete and it is phased out
Script version 0.17
Changelog:
Added hey0's mod update command updatehmod Added function to backup hey0 config files backupconfig
updatehmod
- This will download and replace the current Minecraft_Mod.jar file.
- This will also remove the current minecraft_server.jar file and replace it with a new version (if available)
backupconfig
- This will backup your config files for hmod and throw them in a tar file. Your output email will specify which one is available.
Script version 0.18
Changelog:
Merged update and updatehmod - These commands did the same thing. Removed command updatescripts (see Script version 0.16)
No new commands available
Script version 0.19
Changelog:
Added new function to restore backups Added new file: backup-restore.txt
restoreworld
- This will restore a world based on a backup location specified in backup-restore.txt
Script version 0.2
Changelog:
Cleaning up subroutines. If there are any strange anomalies with command console or adverts, please let CW know. Adding feature to automatically restart the server. Adding feature to reset your world file
Available Commands
Script version 0.21
Changelog:
Added ability to toggle hMod on or off. Falls back to vanilla minecraft.
Available Commands
Script version 0.22
Changelog:
-Optimized some back-end code for update processes
Script version 0.23
New admin mod coming! Minor patch to get things stable.
Changelog:
-All update commands for mods disabled for future Bukkit implementation. This includes autoupdate. -update command rewritten to update just minecraft vanilla. -Modified backupconfig to remove hMod support and add new native white-list.txt -Made togglemod a one way ticket.
Script version 0.24
Added ability to install bukkit, and remove some of the junk files hMod spewed out while deployed.
Changelog:
-Fixed a major bug that was causing the Command Console to stop working since version 0.23 -Added command bukkit to install Bukkit
Script version 0.25
Added a lockfile and added an intelligent backup system. For more information please see below.
Changelog:
-Lockfile will lock the script from running more than once within a script's runtime. This fixes a bug where duplicate emails were being sent out while a command is being ran. -The current version of the backup script was not taking custom world file names into account when preforming backups. By default, the world/ folder was backed up. The script will now look in server.properties for the correct world file config and start to backup that folder instead.
Unstable Version
The development functions are available to the script but are considered unstable until a full line of tests are completed. Please note, unstable functions are to be used at your own risk! Data loss may occur while using these functions!
Script version 0.25.1
Added a function to update to the latest bukkit version available in their "Recommended" builds: updatebukkit
Changelog:
-Added updatebukkit
Dev notes
This was loosely tested and not slated to be used in the auto update process. There is a possibility some of your plugins will stop working when updating. Unless you know for sure your plugins are supported for the new version of Bukkit, "don't fix what ain't broke".
Future Version Plans
New features!