So I've been using Czahrien's server wrapper since he released it and there hasn't been an update in over 2 weeks. So I thought I'd pick up where he left off and try my best to work on the wrapper - mostly for modifications on my server at the moment.
I'm open to suggestions, but keep in mind this is a wrapper. It can only interact with the server console and automate processes, not add functionality like Llamacraft.
Please let me know if anything works incorrectly or if there are undocumented changes.
[*:3l9idl8h]changed item summoning limit from 64 to 512
[*:3l9idl8h]kits remodeled around point system with new kit.txt syntax "<name> <point req> <item1 item2 item3 ...>"; any player that meets or exceeds the point requirement (players default at 0) can summon the kit. If you don't want to use this functionality at all, simply set the point requirement in kit.txt to a very high number
[*:3l9idl8h]#help removed due to spam
[*:3l9idl8h]you can now summon multiples of kits (i.e. "#s wool 64", "#give kinoftheflames diamondTools 5")
Old Thread: viewtopic.php?f=1012&t=23127
Old Thread copy at time of this thread's creation:
[code][b]NOTE: This does NOT work on Windows XP for some people. I don't know why. I personally run the wrapper on Mac OS and Windows 7. I have heard reports of it working just fine under Vista and several flavors of Linux.[/b]
[size=xx-large][b]IMPORTANT: As of release 5.9, the wrapper uses a properties file. Commandline arguments are no longer used! Edit ServerLauncher.properties to fit your server.[/b][/size]
I should've done this days ago to make managing releases easier but I set up an SVN repository at code.google.com.
[b]Current release:[/b] http://code.google.com/p/minecraft-serverwrapper/downloads/list
[b]Release 5.9:[/b] (early preview of release 6) http://www.mediafire.com/?5oflek09ryd9rz3
[b]Mirror: [/b] ftp://ftp.psyc0lops.net/public/
[size=xx-large]
[b]Release notes:[/b][/size]
[b]Version 5.9:[/b]
-New command: #ipban
-New command: #points - keeps track of a point value for players. Use is up to server administrators.
-capability to autosave preferences file.
-autokicks and ipbans players who have invalid characters in their name.
-players with periods in their name can now use commands.
-Reads in information from a properties file.
-playercap: give it a number to limit the number of players or leave it out of the file for no player cap.
-playerwhitelist: set to true to kick non-allowed players
-itemwhitelist: set to true to use white-list summon prevention
-fun: set to true to allow non-trusted players to summon items.
-autosave: set to true to automatically save settings files every ten minutes
-ram: set to the number of mb of ram to use for the server (default: 1024)
[b]Version 6.0-preview:[/b]
- New command: #iplist: Lists users and their IPs
- New command: #motd: Reads in message from motd.txt
- New command: #rules: Reads in rules from rules.txt
- New command: #help
- Bug-fix: #give <name> <kit> no longer crashes if given the name of an invalid kit.
My choice of compressing with tar.gz was somewhat intentional and somewhat a convenience thing. If you don't know what to do with that kind of file and don't know how to find out if you are desperate, just walk away.
Also: Don't be a douchebag and claim any of this code is yours. I don't mind if you use any of this code in your own wrapper, modify it to your tastes, etc. Make sure you give credit where credit is due. While I won't claim that the code is "mine" per se, I wrote all the code in this from scratch. I won't take credit for all ideas however.
While this isn't the first wrapper/chat scraper out but it does seem to do a bit more than others I am seeing. Regardless, I have been running it since I got the first command (#summon) working and players have been having a blast.
This wrapper was developed on a Mac, tested on a Mac, and is currently being run on a Windows machine. With proper setup of the machine and execution of the wrapper, the operating system used should not matter.
NOTE: This wrapper uses the [b]NON-GUI[/b] version of the server.
[size=xx-large][b]Features:[/b][/size]
- Administrator level and trusted player level privileges.
- Fully toggleable summon command for players.
- Blacklist items you don't want non-trusted players summoning or whitelist items you want to allow them to summon.
- Kick and ban players. (ban auto-kicks players that attempt to join).
- White-list banning mode (auto-kick all players that are not in the allow file).
- Kicking non-admin/non-trusted players that attempt to join past a certain threshold.
- Server commands typed in the command line wrapper are sent to the server. "stop" will stop the wrapper and the server gracefully as well as save your admin, ban, and trusted lists.
[size=xx-large][b]Commands:[/b][/size]
:Bench: [b]All:[/b]
[i]#summon <item-id> [<count>][/i]: Summons count or 1 of item-id.
[i]#summon <kit>[/i]: Summons a set of items defined in kits.txt.
[i]#list[/i]: Lists connected players.
[i]#time[/i]: Displays the server time.
[i]#uptime[/i]: Displays server uptime.
[i]#points[/i]: Display how many points you have
[i]#help[/i]: Displays a list of commands and their use.
[i]#rules[/i]: Displays the contents of rules.txt.
[i]#motd[/i]: Displays the contents of motd.txt
:tnt: [b]Trusted:[/b]
[i]#summon[/i]: Can summon blacklisted/unwhitelisted items if fun is enabled. Non-blacklisted/whitelisted items if fun is disabled.
:opblock: [b]Admin-only:[/b]
[i]#fun[/i]: toggles "fun" game-breaking commands such as #summon. Fun mode is [b]DIS[/b]bled by default as of the third release. NEW BEHAVIOR: When fun mode is on, trusted players can summon blacklisted items. When it is off, they can summon any non-blacklisted items
[i]#kick <player>[/i]: Obvious
[i]#ban/#unban <player>[/i]: Bans/unbans players. That easy. This is not available on white-list banning servers (as it does not make sense)
[i]#allow/unallow <player>[/i]: Allows/disallows players from joining. This is only available on white-list banning servers.
[i]#trust/#untrust <player>[/i]: adds/removes player from trusted list
[i]#blacklist/#unblacklist <item-id>[/i]: prevents/allows players from/to summon a given item-id. This is not available on white-list summoning servers.
[i]#whitelist/#unwhitelist <item-id>[/i]: allows/prevents players to/from summon a given item-id. This is not available on normal, non-white-list summoning servers.
[i]#admin <player>[/i]: makes player an admin
[i]#reload/#save[/i]: reload/save the *.txt files.
[i]#stop[/i]: Stops the server.
[i]#give <player> <id> <count> // #give <player> <kit>[/i]: Gives the specified player count * id or a kit.
[i]#ipban <playername or IP>[/i]
[i]#points <player> (<amount to add>)[/i]: Displays the point that player has if no amount is specified or adds the amount given to the player.
[i]#iplist [online][/i]: "#iplist" alone will list names and last IP of anybody who has logged onto the server since it booted up. "#iplist online" will list names and IP of only the players that are online.
Saying # commands from the console now works.
[b]Upcoming Features in next version: [/b]
- #summon <kit> <count>
- #give <player> <kit> <count>
- #votekick/#voteban for players. (with ways of turning them off)
- Ways to limit the summoning of kits based on status and/or frequency of use.
- Automatic server restarts are a possibility.
[size=xx-large][b]How to get it running:[/b] [/size]
[b]1.[/b] Extract the tar.gz file in the directory of the server jar (NOT the .exe, you need the non-gui server).
[b]1.5.[/b] (Windows only) If you are on a Windows machine make sure your PATH (DO NOT TOUCH CLASSPATH) environment variable is set correctly for Java. As the wrapper's internals requires this!
* See http://www.cs.princeton.edu/introcs/15inout/windows-cmd.html for setting your paths variable and keep in mind that your "Java" folder may be located in "Program Files (x86)" instead of "Program Files".
[b]2.[/b] Edit ServerLauncher.properties to your heart's content.
[b]3.[/b] Run server.bat if you are on a windows machine or server.sh if you are on a *nix/max machine. Alternatively you can run the following from the commandline:
[code]java ServerLauncher[/code]
Whitelist banning uses allowed.txt instead of banned.txt. Whitelist summon prevention uses white_list.txt instead of black_list.txt.
File list and formats:
admins.txt, trusted.txt, banned.txt/allowed.txt: Contains the name of a players, each on their own lines.
kits.txt: Contains the name of the kit followed by item-ids delimited by a single space
black_list.txt/white_list.txt: contains item-ids (and is soon to include compatability with kits) each on their own lines.
ipbans.txt: IP bans. One IP per line.
points.txt: Each line is a playername, followed by a space, followed by the amount of points they have.
I think you can notify me of bugs on the google code site. Please, do so. There is a chance I won't see what you post in this forum as I am going to be quite busy over the next three days. Oh and if you have complaints about how long and obnoxious #help is I don't want to hear them since everybody wanted it in the first place.
I am hanging out on the Minecraft IRC server. Feel free to drop by and ask questions but I will NOT hold your hand through running the wrapper.[/code]
I'm probably not going to continue to update this since I've got new things taking up my time and I've switched my server mod to hey0's. Sorry for the non-windows users the reason it doesn't work is because of a specific line in the part where it starts up the server so it will run with a high priority to the CPU (which is obviously OS dependent).
I'm open to suggestions, but keep in mind this is a wrapper. It can only interact with the server console and automate processes, not add functionality like Llamacraft.
Please let me know if anything works incorrectly or if there are undocumented changes.
Downloads:
6.0: http://www.mediafire.com/?eg2kuyh09egqq7u
Patch Notes:
6.0:
[*:3l9idl8h]changed item summoning limit from 64 to 512
[*:3l9idl8h]kits remodeled around point system with new kit.txt syntax "<name> <point req> <item1 item2 item3 ...>"; any player that meets or exceeds the point requirement (players default at 0) can summon the kit. If you don't want to use this functionality at all, simply set the point requirement in kit.txt to a very high number
[*:3l9idl8h]#help removed due to spam
[*:3l9idl8h]you can now summon multiples of kits (i.e. "#s wool 64", "#give kinoftheflames diamondTools 5")
Old Thread: viewtopic.php?f=1012&t=23127
Old Thread copy at time of this thread's creation:
[code][b]NOTE: This does NOT work on Windows XP for some people. I don't know why. I personally run the wrapper on Mac OS and Windows 7. I have heard reports of it working just fine under Vista and several flavors of Linux.[/b] [size=xx-large][b]IMPORTANT: As of release 5.9, the wrapper uses a properties file. Commandline arguments are no longer used! Edit ServerLauncher.properties to fit your server.[/b][/size] I should've done this days ago to make managing releases easier but I set up an SVN repository at code.google.com. [b]Current release:[/b] http://code.google.com/p/minecraft-serverwrapper/downloads/list [b]Release 5.9:[/b] (early preview of release 6) http://www.mediafire.com/?5oflek09ryd9rz3 [b]Mirror: [/b] ftp://ftp.psyc0lops.net/public/ [size=xx-large] [b]Release notes:[/b][/size] [b]Version 5.9:[/b] -New command: #ipban -New command: #points - keeps track of a point value for players. Use is up to server administrators. -capability to autosave preferences file. -autokicks and ipbans players who have invalid characters in their name. -players with periods in their name can now use commands. -Reads in information from a properties file. -playercap: give it a number to limit the number of players or leave it out of the file for no player cap. -playerwhitelist: set to true to kick non-allowed players -itemwhitelist: set to true to use white-list summon prevention -fun: set to true to allow non-trusted players to summon items. -autosave: set to true to automatically save settings files every ten minutes -ram: set to the number of mb of ram to use for the server (default: 1024) [b]Version 6.0-preview:[/b] - New command: #iplist: Lists users and their IPs - New command: #motd: Reads in message from motd.txt - New command: #rules: Reads in rules from rules.txt - New command: #help - Bug-fix: #give <name> <kit> no longer crashes if given the name of an invalid kit. My choice of compressing with tar.gz was somewhat intentional and somewhat a convenience thing. If you don't know what to do with that kind of file and don't know how to find out if you are desperate, just walk away. Also: Don't be a douchebag and claim any of this code is yours. I don't mind if you use any of this code in your own wrapper, modify it to your tastes, etc. Make sure you give credit where credit is due. While I won't claim that the code is "mine" per se, I wrote all the code in this from scratch. I won't take credit for all ideas however. While this isn't the first wrapper/chat scraper out but it does seem to do a bit more than others I am seeing. Regardless, I have been running it since I got the first command (#summon) working and players have been having a blast. This wrapper was developed on a Mac, tested on a Mac, and is currently being run on a Windows machine. With proper setup of the machine and execution of the wrapper, the operating system used should not matter. NOTE: This wrapper uses the [b]NON-GUI[/b] version of the server. [size=xx-large][b]Features:[/b][/size] - Administrator level and trusted player level privileges. - Fully toggleable summon command for players. - Blacklist items you don't want non-trusted players summoning or whitelist items you want to allow them to summon. - Kick and ban players. (ban auto-kicks players that attempt to join). - White-list banning mode (auto-kick all players that are not in the allow file). - Kicking non-admin/non-trusted players that attempt to join past a certain threshold. - Server commands typed in the command line wrapper are sent to the server. "stop" will stop the wrapper and the server gracefully as well as save your admin, ban, and trusted lists. [size=xx-large][b]Commands:[/b][/size] :Bench: [b]All:[/b] [i]#summon <item-id> [<count>][/i]: Summons count or 1 of item-id. [i]#summon <kit>[/i]: Summons a set of items defined in kits.txt. [i]#list[/i]: Lists connected players. [i]#time[/i]: Displays the server time. [i]#uptime[/i]: Displays server uptime. [i]#points[/i]: Display how many points you have [i]#help[/i]: Displays a list of commands and their use. [i]#rules[/i]: Displays the contents of rules.txt. [i]#motd[/i]: Displays the contents of motd.txt :tnt: [b]Trusted:[/b] [i]#summon[/i]: Can summon blacklisted/unwhitelisted items if fun is enabled. Non-blacklisted/whitelisted items if fun is disabled. :opblock: [b]Admin-only:[/b] [i]#fun[/i]: toggles "fun" game-breaking commands such as #summon. Fun mode is [b]DIS[/b]bled by default as of the third release. NEW BEHAVIOR: When fun mode is on, trusted players can summon blacklisted items. When it is off, they can summon any non-blacklisted items [i]#kick <player>[/i]: Obvious [i]#ban/#unban <player>[/i]: Bans/unbans players. That easy. This is not available on white-list banning servers (as it does not make sense) [i]#allow/unallow <player>[/i]: Allows/disallows players from joining. This is only available on white-list banning servers. [i]#trust/#untrust <player>[/i]: adds/removes player from trusted list [i]#blacklist/#unblacklist <item-id>[/i]: prevents/allows players from/to summon a given item-id. This is not available on white-list summoning servers. [i]#whitelist/#unwhitelist <item-id>[/i]: allows/prevents players to/from summon a given item-id. This is not available on normal, non-white-list summoning servers. [i]#admin <player>[/i]: makes player an admin [i]#reload/#save[/i]: reload/save the *.txt files. [i]#stop[/i]: Stops the server. [i]#give <player> <id> <count> // #give <player> <kit>[/i]: Gives the specified player count * id or a kit. [i]#ipban <playername or IP>[/i] [i]#points <player> (<amount to add>)[/i]: Displays the point that player has if no amount is specified or adds the amount given to the player. [i]#iplist [online][/i]: "#iplist" alone will list names and last IP of anybody who has logged onto the server since it booted up. "#iplist online" will list names and IP of only the players that are online. Saying # commands from the console now works. [b]Upcoming Features in next version: [/b] - #summon <kit> <count> - #give <player> <kit> <count> - #votekick/#voteban for players. (with ways of turning them off) - Ways to limit the summoning of kits based on status and/or frequency of use. - Automatic server restarts are a possibility. [size=xx-large][b]How to get it running:[/b] [/size] [b]1.[/b] Extract the tar.gz file in the directory of the server jar (NOT the .exe, you need the non-gui server). [b]1.5.[/b] (Windows only) If you are on a Windows machine make sure your PATH (DO NOT TOUCH CLASSPATH) environment variable is set correctly for Java. As the wrapper's internals requires this! * See http://www.cs.princeton.edu/introcs/15inout/windows-cmd.html for setting your paths variable and keep in mind that your "Java" folder may be located in "Program Files (x86)" instead of "Program Files". [b]2.[/b] Edit ServerLauncher.properties to your heart's content. [b]3.[/b] Run server.bat if you are on a windows machine or server.sh if you are on a *nix/max machine. Alternatively you can run the following from the commandline: [code]java ServerLauncher[/code]
Whitelist banning uses allowed.txt instead of banned.txt. Whitelist summon prevention uses white_list.txt instead of black_list.txt.
File list and formats:
admins.txt, trusted.txt, banned.txt/allowed.txt: Contains the name of a players, each on their own lines.
kits.txt: Contains the name of the kit followed by item-ids delimited by a single space
black_list.txt/white_list.txt: contains item-ids (and is soon to include compatability with kits) each on their own lines.
ipbans.txt: IP bans. One IP per line.
points.txt: Each line is a playername, followed by a space, followed by the amount of points they have.
I think you can notify me of bugs on the google code site. Please, do so. There is a chance I won't see what you post in this forum as I am going to be quite busy over the next three days. Oh and if you have complaints about how long and obnoxious #help is I don't want to hear them since everybody wanted it in the first place.
I am hanging out on the Minecraft IRC server. Feel free to drop by and ask questions but I will NOT hold your hand through running the wrapper.[/code]