mirror of
https://github.com/Tiiffi/mcrcon.git
synced 2025-10-30 21:01:07 -04:00
117 lines
4.0 KiB
Markdown
117 lines
4.0 KiB
Markdown
####Compiling:
|
|
|
|
Compile with GCC or CLANG:
|
|
```cc -std=gnu11 -Wpedantic -Wall -Wextra -O2 -s -o mcrcon mcrcon.c```
|
|
|
|
or just run **make**.
|
|
|
|
On windows, remember to link with winsockets.
|
|
Add ```-lws2_32``` to compiler command line on Mingw GCC.
|
|
|
|
---
|
|
|
|
####Usage:
|
|
Usage: mcrcon [OPTIONS]... [COMMANDS]...
|
|
Sends rcon commands to minecraft server.
|
|
|
|
```
|
|
Option:
|
|
-h Print usage.
|
|
-s Silent mode. Do not print data received from rcon.
|
|
-t Terminal mode. Acts as interactive terminal.
|
|
-p Rcon password. Default: "".
|
|
-H Host address or ip.
|
|
-P Port. Default: 25575.
|
|
-c Disable colors.
|
|
-r Output raw packets.
|
|
Good for debugging and custom handling of the output.
|
|
```
|
|
Commands must be separated with spaces.
|
|
|
|
Example:
|
|
```mcrcon -c -H 192.168.1.42 -P 25575 -p password cmd1 "cmd2 arg1 arg2"```
|
|
|
|
#####Enable server rcon
|
|
Remember to enable rcon by changing / adding following lines in ```server.properties``` file.
|
|
```
|
|
enable-rcon=true
|
|
rcon.port=25575
|
|
rcon.password=your_rcon_pasword
|
|
```
|
|
|
|
---
|
|
|
|
####Contact:
|
|
|
|
* WWW: http://sourceforge.net/projects/mcrcon/
|
|
* MAIL: tiiffi_at_gmail_dot_com
|
|
* IRC: tiiffi @ quakenet
|
|
* BUG REPORTS: https://github.com/Tiiffi/mcrcon/issues/
|
|
|
|
---
|
|
|
|
####Version history:
|
|
######0.0.5
|
|
- IPv6 support!
|
|
* Thanks to 'Tanja84dk' for addressing the real need of IPv6.
|
|
|
|
- Fixed bug causing crash / segmentation fault (invalid write) when receiving malformed rcon packet.
|
|
|
|
- Program makes use of C99 feature (variable-length arrays) so "-std=gnu99" flag on
|
|
GCC-compiler must be used to avoid unecessary warnings.
|
|
|
|
- Rcon receive buffer is now bigger (2024 bytes -> 10240 bytes).
|
|
* Thanks to 'gman_ftw' @ Bukkit forums.
|
|
|
|
- Fixed invalid error message when receiving empty rcon packet (10 bytes).
|
|
* Thanks to 'pkmnfrk' @ bukkit forums.
|
|
|
|
- Terminal mode now closes automatically when rcon socket is closed by server
|
|
or if packet size cannot be retrieved correctly.
|
|
|
|
- Client now tries to clean the incoming socket data if last package was out of spec.
|
|
|
|
######0.0.4
|
|
- Reverted back to default getopts options error handler (opterr = 1).
|
|
Custom error handler requires rewriting.
|
|
- Some cosmetic changes in program output strings.
|
|
- Program usage(); function now waits for enter before exiting on Windows.
|
|
|
|
######0.0.3
|
|
- Colors are now supported on Windows too!
|
|
- Terminal mode is now triggered with "-t" flag. "-i" flag still works for
|
|
backwards compatibility.
|
|
- Bug fixes (Packet size check always evaluating false and color validity
|
|
check always evaluating true).
|
|
|
|
######0.0.2
|
|
- License changed from 'ISC License' to 'zlib/libpng License'.
|
|
- Bug fixes & code cleanups
|
|
- Interactive mode (-i flag). Client acts as interactive terminal.
|
|
- Program return value is now the number of rcon commmands sent successfully.
|
|
If connecting or authentication fails, the return value is -1.
|
|
- Colors are now enabled by default. Now '-c' flag disables the color support.
|
|
|
|
######0.0.1
|
|
- Added experimental support for bukkit colors.
|
|
Should work with any sh compatible shell.
|
|
- Packet string data limited to max 2048 (DATA_BUFFSIZE) bytes.
|
|
No idea how Minecraft handles multiple rcon packets.
|
|
If someone knows, please mail me so I can implement it.
|
|
|
|
####TODO:
|
|
- Make the receive buffer dynamic??
|
|
- Change some of the packet size issues to fatal errors.
|
|
- Code cleanups.
|
|
- Check global variables (remove if possible).
|
|
- Add some protocol checks (proper packet id check etc..).
|
|
- Preprocessor (#ifdef / #ifndef) cleanups.
|
|
- Follow valve rcon protocol standard strictly?
|
|
- Multiple packet support if minecraft supports it?!
|
|
- Investigate if player chat messages gets sent through rcon.
|
|
If they are, the messaging system requires rewriting.
|
|
- Name resolving should be integrated to connection creation function.
|
|
- Dont try to cleanup the socket if not authenticated
|
|
- Better sockets error reporting
|
|
- Better error function (VA_ARGS support)
|