Tournaments

Tournaments is a Pixelmon sidemod and Sponge plugin for creating Pokémon tournaments. It also provides an API to further customize tournaments.

Installation

Tournaments is a Sponge plugin, which means it is only for installation on servers. It requires both Pixelmon and SpongeForge to install. The plugin only needs to be in the mods directory of the server for it to run.

Usage

The first step in running a tournament is creating the tournament with "/tournament create". This creates a new tournament, but does not immediately open it for joining. The tournament can be configured with rule- and reward-adding commands, with the base "/tournament" command to check the existing tournaments settings. Using /tournament open will open it for players to join and send a server-wide announcement advertising the tournament. Players can join using "/tournament join". Once players have joined, tournament admins can use "/tournament start" to start the first tournament round. After starting the tournament, it will continue to run automatically until it is completed.

Commands

Note: Command syntax is displayed in the standard Minecraft command format. An explanation of this format can be found here.

• /tournament: Gives general information about any current tournament, including rules, current matches, and teams.
  • create [preset] [<rule-type[:argument]>...]: Creates a new tournament. Having arguments after create will be interpreted as presets to load, otherwise rules or rewards to add.
  • open: Opens the created tournament for players to join.
  • start: Signals the tournament controller to start the tournament. After it has started, the first round will be calculated and started.
  • close: Shuts down any existing tournament.
  • rules: Gives the list of rules for any current tournament.
    • add <rule-type[:argument]>: Adds a rule to the tournament, given rule type and the optional argument. E.g., "/tournament rules add levelmax:50".
    • remove <rule-type>: Removes all current rules of the given type.
    • test [player]: Tests whether a player, and if possible the player's team and side, passes the rules of the tournament. This is primarily for testing custom rules.
  • zones: Lists the current zones for battle areas. Through the provided interface, new ones can be created or removed.
    • leavezone: Warps to the currently set leave zone. This is the zone players are warped to after their matches end.
      • set: Sets the leave zone for the tournament.
  • presets: Checks the registered presets for rules and rewards.
    • save <name>: Saves the current tournament's rules and rewards to a preset with the given name. If the given name already exists as a preset, it is overwritten.
    • load <name>: Loads the preset with the given name (if it exists) into the current tournament.
    • delete <name>: Deletes the preset with the given name. This cannot be undone.
    • rename <old name> <new name>: Renames a preset.
  • join [teammate]: Joins the tournament. If a player name is given and the tournament allows double teams, the player is invited to join as a double team.
  • leave: Leaves the tournament, if possible. This is not possible in later stages of the tournament, and instead forfeiting is necessary.
  • forfeit [player]: Forfeits the tournament. If a player argument is provided and the user has permission, the given player will be forced to forfeit.
  • flag: Flags a battle as bugged. If both sides flag a battle as bugged, it will be turned into a rematch.
  • ignore [true/false]: Toggles or sets for the user whether tournament messages should be hidden.
  • rewards: Gives the list of rewards for any current tournament.
    • add <reward-type[:argument]>: Adds a reward to the tournament, given the rule type and the optional argument. E.g., "/tournament rewards add pokemon:starly,lvl:5,s,gr:Enormous".
    • remove <reward-type>: Removes all current rewards of the given type.
    • test [player]: Gives the sender or the optional argument player the rewards for the tournament. This is primarily for testing custom rewards.
  • reroll: Gets a new set of random Pokémon, provided the tournament has the RandomPokemon rule with some number of rerolls allowed, and the player has some rerolls remaining.

Permission nodes

Admin nodes

Note: All admin nodes can be given at once by setting "tournaments.command.admin".

• tournaments.command.admin.create: Permission to create a tournament.
• tournaments.command.admin.tournaments: Permission to open/close/start a tournament.
• tournaments.command.admin.rules: Permission to modify rules, and see normally hidden rules.
• tournaments.command.admin.rewards: Permission to modify rewards and see normally hidden rewards.
• tournaments.command.admin.presets: Permission to handle presets for rules and rewards.
• tournaments.command.admin.forfeit: Permission to force other players to forfeit.
• tournaments.command.admin.zones: Permission to set and inspect zones.

Common nodes

Note: All common nodes can be given at once by setting "tournaments.command.common".

• tournaments.command.common.tournaments: Permission to view basic tournament information.
• tournaments.command.common.join: Permission to join a tournament.
• tournaments.command.common.leave: Permission to leave a tournament.
• tournaments.command.common.forfeit: Permission to forfeit.
• tournaments.command.common.ignore: Permission to ignore a tournament's messages.
• tournaments.command.common.rules: Permission to view a tournament's rules.
• tournaments.command.common.rewards: Permission to view a tournament's rewards.
• tournaments.command.common.flag: Permission to flag a battle as bugged.
• tournaments.command.common.reroll: Permission to get a new set of random Pokémon

Provided implementations

Rules

General rules

• battletype [option] : Sets the type of battles that will occur depending on the option.
  • single : Standard single battles, teams are only allowed to have 1 player.
  • double : Double battles, teams are allowed to have either 1 or 2 players. Note: This is best coupled with a partymax rule.
  • double1: Double battles, teams are only allowed to have 1 player.
  • double2: Double battles, teams are only allowed to have 2 players.
• teamcap:<cap>[,autostart]: Establishes a cap on the number of teams that may join the tournament. If "autostart" is set, the tournament will begin the moment the tournament is full.

Decider rules

• healthtotal[:weight]: If a battle crashes, a victor will be decided by the side who has the most HP. If a weight is provided, the higher it is, the higher the priority of this decision. Defaults to 1.
• partycount[:weight]: If a battle crashes, a victor will be decided by the side who has the most unfainted Pokémon. If a weight is provided, the higher it is, the higher the priority of this decision. Defaults to 3.

Team rules

• partymax:<1-6>: A team's party (all the Pokémon for every player in the team) is counted (excluding Eggs), and the team is disqualified if the total is larger than the given maximum.
• partymin:<1-6> : A team's party (all the Pokémon for every player in the team) is counted (excluding Eggs), and the team is disqualified if the total is less than the given minimum.

Player rules

• levelmax:<1-100>: Every Pokémon in a player's party must have a level less than or equal to the given maximum.
• levelmin:<1-100>: Every Pokémon in a player's party must have a level greater than or equal to the given minimum.
• healing:<true/false>: If true, healing between battles is both permitted and automated. If false, players will be disqualified if their parties get new Pokémon or their Pokémon are healed in any way.
• legendaries:<true/false>: If true, Legendary Pokémon will be permitted. If false, no one may use Legendary Pokémon.
• disallowedability:<ability[,ability,...]> : A team may not have the specified ability(s) (case sensitive). Adding this rule multiple times adds to the list.
• helditems<true/false> : If true, held items are allowed. If false, no one may use Pokémon holding held items.

Rewards

• pokemon:<name[,option,...]>: A Pokémon reward. This is in the same format as the /pokegive and /pokespawn commands. E.g., "Gyarados,level:1,s,ab:Moxie".
• items:<player>: A reward of various items. The given player is the player whose inventory will be taken and used as the reward.
• money:<amount>: A reward of the given amount of money.