Thread: Jazz Jackrabbit 2 Plus [Download JJ2+]

For all the information, please see the build notes.

Known Issues
================================================== ==============================
-In the menu bar, Plus Settings does nothing useful. This will eventually change...
-Downloaders cannot receive chat, for lag reasons. I have other lag issues to solve though.
-Downloaders automatically get kicked on level cycling, because I haven't figured out a better method yet...
-Loading plus.exe while starting a server (when the screen is all black), on the connecting screen, or on
the Network error screen (which you see after the server stops or you get kicked) will cause JJ2 to
crash.
-Game Mode and Max Score changes causes glitches for splitscreeners not running JJ2+.
-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.



Playlog
================================================== ==============================
About Points and Roasts in the stats:

The Points stat is based off the number of roasts a player has and includes point decreases from pit deaths
and similar. In other words, it's the number of "roasts" you see on the screen during a JJ2 game. The Roasts
stat is strictly the number of kills a player has in a given game. This is true for all custom modes and game
modes that record these stats. For custom modes like Roast Tag and battle games with pits, "Points" makes a
lot more sense. I know it's not immediately obvious what points and roasts means in the Playlog, especially
in team games, but now you know. I am considering using the word "Points" in the HUD for Battle mode in the
near future.



Level List
========================================
To add levels to the Level, you can select the levels within your JJ2 folder and drag them over plus.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, Race,
FlagRun, and Jailbreak. The number before the equal sign must be between 001 and 999, and the leading
zeros are required.



Remote Admin
========================================
When Remote Admin is enabled, a client can login as an admin by typing the command "/login <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 (plus.ini), a random password
will be generated for safety reasons. Passwords are NOT case sensitive. Any attempt to login (whether
Remote Admin 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 "/n <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 players running JJ2+, F9 can be used to see who has Admin Access. Those who do will
have a green "A" next 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 three 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 90 seconds, or else that player
will lose a point and cease to be IT. After that, there is another free-for-all.



Flag Run
========================================
There is one "flag" which both teams can capture, usually located somewhere in the middle of the level.
The flag holder must return the flag to the opponent's base before time runs out or else the flag holder
will self-destruct and lose the flag. The flag holder's team has 45 seconds to score on flag captures,
and 30 seconds to score on flag steals. A flag can be stolen by roasting the flag holder when he/she
has 15 seconds or less to score.

Scoring:
45-31 seconds left: 3 points + extra points
30-16 seconds left: 2 points + extra points
15-0 seconds left: 1 point + extra points

On flag captures, extra points start at 0.
On flag passes and flag steals, extra points get set to 1.
Each roast by the flag holder adds 1 extra point.
Extra points can be 3 at the most.



Team Last Rabbit Standing
========================================
Teams have a set number of lives which are divided among the players of a team. No player cannot receive more
points than Max Lives. If there are lives left over, they go into a team's reserves. When players lose all
their lives, and their team has reserves, the remaining reserves are divided among all players of the same
team who are out. Game ends when only one team has remaining lives left.



Domination
========================================
Teams try to capture the control points in a level. Each team receives a set number of points equal to the
number of the control points a team has currently captured every 5-20 seconds. The number of seconds between
each score depends on the total number of control points in the level:
1-4 control points: 5 seconds
5-8 control points: 10 seconds
9-12 control points: 15 seconds
13-16 control points: 20 seconds

Neutral control points (that is, control points not controlled by any team yet) are shown as a spinning white
circle. Once a player touches it, after a one second delay the control point will turn into a Super Gem in the
color of the player's team. Captured control points can then be captured by another team in a similar manner.
The team that currently holds a control point can prevent its capture by another team by touching the control
point within a second after another team has touched it.

In JCS, control points are created by marking any event as Easy or Hard. Control points marked as "Easy" face
to the right, while control points marked as "Hard" face to the left. If the event used is a text event, the
control point is named after the text string used with that event. If the event used is NOT a text event, the
control point will be automatically named based off it's relative position to other control points. For example,
if there are two control points and none of them use a text event, the control point closest to the top and
furthest to the left would be named "Control Point 1", and the other control point would be named
"Control Point 2". The control point ordering goes from top to bottom and left to right.



Pit Levels
========================================
See pitlevelex.j2l for a basic idea of what a level with pits looks like. For a level to be able to use pits,
the event at the bottom-right corner of level must be 255 (see below). 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.

How to set event 255 at the bottom-right corner of a level:
1.) Right-click the bottom-right corner and choose "Select Event."
2.) Click the box for "Create a generator for this event."
3.) Change the Event number to 255 then click "OK."
4.) Select the event again, uncheck "Create a generator," then click "OK."