Carrotade v1.2
Created by BlurredD based on Neobeo's code
With much help from Monolith
Credits: Neobeo, Monolith, EvilMike, Bobby aka Dizzy, Grytolle, Overlord,
Red^Ninja, Salface, Shane Lillie, Clemens Fischer (win32 named pipes),
all the people who worked on PrcHelp (http://www.apihooks.com/PH.HTM),
the [semi-idle], Syntax (who made the originally Roast Tag rules), and
others who (might?) know who they are.
Beta-testers: Cooba, Blackraptor, Sciz CT.
A Warning...
========================================
Some of the features included with this program can easily be misused.
Granted clients are allowed to leave your server any time they choose, it
is best not to alienate them by abusing certain features. Use this program
responsibly, or don't use it at all...
Change Log
========================================
Version 1.1
------------------------------------
- Renamed "/cycle" command to "/endtime" for less ambiguity.
- Added kickban command (mainly for admin use, see below).
- Carrotade now loads when game is on the menu.
- Added Admin Access so clients can log onto a server with a password
and issue certain Carrotade commands.
A reminder: Exercise caution while using Admin Access.
Version 1.2
------------------------------------
- Fixed bug in TSF where JJ2 would crash when a player tries to capture
a flag.
- Fixed bug with "/n" and "/c" commands so that <level_filename>
no longer has to be in the Level List.
Admins (still) can only use those two commands with levels that are
in your Level List.
Features
========================================
- Fixed Team Chat.
- Fixed cycling while minimized (for the most part).
- Death from Pits (the event at the bottom-right corner of level must
be 255).
- Level List cycling.
- Automatic cycling.
- Chat logging.
- Stats logging.
- IP logging.
- NeoAC protection (with laser prevention).
- Weapon Respawn fix.
- Seeker Hole fix (albeit only local).
- CTF fixes for the following:
- Death near enemy flag. (fixed for the most part)
- Disappearing flags.
- Flag passing.
- Idle player kicking.
- Idle Server mode.
- Automatic renaming players whose names are not visible.
- Hidden joined/left messages for server info scripts used by Nimrod's
GIP and JazzForce.
- Admin Access.
- Full TSF support.
- Other features I don't feel like listing at the moment (see Carrotade
Commands).
Known Issues
========================================
- This program is incompatible with NeoAC, and may conflict with
Forest, Project Controller, and other utilities and patches made recently.
- Problems may occur from restarting the server while the program is
loaded.
- Team Battle requires levels with only Jazz/Spaz Start positions or MP
Start positions for both teams.
- Team Battle causes clients to see random capture messages if flags
for both teams are not in the level.
- Team Chat may not work properly if the gametype is changed midgame to
CTF.
- Changing a player's team may lead to bad triggers (such as for
team-based triggers) depending on the level.
- Shuffling teams while splitscreeners are in the server may cause bad
triggers as well as other problems.
- Start positions, warp targets, and platforms too close to the bottom
of a level with pits may cause problems.
- Idle player detection is not complete, although nearly all idle
players will be kicked.
Level List
========================================
To add levels to the Level, you can select the levels within your JJ2
folder and drag them over the exe. By default, the levels will be added to
the first section of levellist.ini. If the first section cannot be found or
the ini file does not exist yet, levels are then added to the section
"Battle". You can also write the filenames directly into levellist.ini
directly. The "j2l" extension must be included. This is the general format
of levellist.ini:
[Battle]
001=levelfilename.j2l
The default section names, based on gamemode, are Battle, TeamBattle, CTF,
Treasure, SinglePlayer, and Race. The number before the equal sign must be
between 001 and 999, and the leading zeros are required.
Admin Access
========================================
When Admin Access is enabled, a client will be able to login as an admin by
typing the command "/adminlogin <password>", where the password is
between 3 to 15 characters long and contains only characters and numbers.
If no password or an invalid password has been stored in the configuration
file (carrotade.ini), a random password will be generated for safety
reasons. Passwords are NOT case sensitive. Any attempt to login (whether
Admin Access is enabled or not) as well as any command issued by an admin
will be hidden to any player in the server who is not an admin. For the
commands "/c <level_filename>" and "<level_filename>", the
admin is limited to the levels that can be found in the Level List
(levellist.ini). Admins lack the ability to kick or ban other admins, so it
is important to make sure those who have the admin password can be trusted.
For the server, F9 can be used to see who has Admin Access. Those who do
will have "Admin" in green text to their name.
Roast Tag
========================================
This is a custom gametype where one player can become IT (i.e. the player
who has "Eva's ring" and has a green name), and everyone else tries to
roast that player. When no one is IT yet, there is a free-for-all, and the
first player to get a roast receives five points then becomes IT.
Afterwards, any time a player kills the one that is IT, the killer will
become IT. In addition, the player with the least points and most deaths
will become the BOTTOM FEEDER and will get a red name. Whenever someone is
IT, the other players, excluding the BOTTOM FEEDER, cannot receive points
unless they roast the player who is IT. The BOTTOM FEEDER can receive one
point for roasting normal players (i.e. players without colored names).
After the first roast, the player who is IT receives one point for roasting
a normal player, then two for the next, three after that, and so on.
Whoever is IT will always receive three points for roasting the BOTTOM
FEEDER. Furthermore, the player that is IT must get a roast every minute
and a half, or else that player will lose a point and cease to be IT. After
that, there is another free-for-all.
Pit Levels
========================================
See pitlevelex.j2l for a basic idea of what a level with pits looks like.
Fly carrots, airboards, copters, and water are recommended not to be used
with pits. Start positions, warp targets, and platforms should not be
placed too close to the bottom of a level since this may cause clients to
get stuck at the bottom. Warp targets where players can fall into a pit
without landing on a platform must especially be avoided. Ammo, carrots,
and other shootable events should be placed in areas where if they are shot
down, they can't fall into a pit.
Carrotade Commands
========================================
/kick <player>
kicks player (gives shareware message to client)
/ban <player>
bans player without kicking
/kickban <player>
kicks and bans player
/start
starts game
/stop
stops games
/autostart <on|off>
enables/disables auto-start
/time
shows end game time and time left
/autocycle <on|off>
enables/disables auto-cycle
/endtime <time> [reset]
sets game end time (in minutes; must be between 1 and 1440)
/c
cycles to next level
/c <level_filename>
sets next level to <level_filename> if it exists, then cycles
/n <level_filename>
sets next level to <level_filename> if it exists
/r
restarts level
/levellist <on|off>
enables/disables Level List Cycling*
/levellist shuffle
shuffles levels within the Level List*
/idleserver <on/off>
enables/disables Idle Server mode*
(automatically enabled after an hour of server inactivity in a Battle
or CTF game)
/kickidlers <on/off>
enables/disables kicking idlers* (not recommended for levels where
shooting and movement is restricted)
/idletime <time>
sets idle time* (in minutes; must be between 1 and 30)
/adminaccess <on/off>
enables/disables admin access*
/setadminpassword <password>
Sets password needed for admins to login* (must be only letters and
numbers and between 3 and 15 characters)
/getadminpassword
Displays password needed for admins to login*
/passing <on|off>
enables/disables flag passing (pass the flag by shooting your teammate
with RFs)
/capture <on|off>
enables/disables flag capture
/ctfMessages <on|off>
enables/disables CTF+ messages
/shuffle
shuffles all players' teams (including splitscreeners; must be done at
the beginning of the game)
/swap <number>
changes player's team (including splitscreeners)
/instagib <on|off>
enables/disables instagib
/frustration <on|off>
enables/disables frustration mode (reciprocal deaths from kills)
/hfk <on|off>
enables/disables health from kills
/da <on|off>
enables/disables damage amplifier
/loadsettings
Loads configution settings* (automatically done at startup)
/savesettings
Saves configution settings*
/stats
logs player stats*
/chatlog <on|off>
enables/disables Chatlog* (requires restart of program)
/playlog <on|off>
enables/disables Playlog* (requires restart of program)
/iplog <on|off>
enables/disables IPlog* (requires restart of program)
/hfkmax <number>
sets max health for hfk (must be between 1 and 7; default = 5)
/healthinc <number>
sets health increase for hfk (must be between 1 and 6; default = 1)
/friendlyfire <on|off>
enables/disables friendly fire (for Roast Tag only)
/off
turns custom mode off
/rt
changes custom mode to Roast Tag if the game mode is Battle
/tb
changes custom mode to Team Battle if the game mode is CTF
/reset
resets the game if the custom mode is roast tag
* This command cannot be used by admins
