Skip to content
Minetest mod PvP Plus, for creating "semi-PvP" servers and allowing PvP tournaments
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
locale
sounds
textures
LICENSE.txt
README.md
depends.txt
init.lua
intllib.lua
mod.conf
pvp.lua
pvp_commands.lua
tournament.lua
tournament_commands.lua
tournament_hud.lua
tournament_motionless.lua

README.md

PvP Plus

This mod adds many PvP features that allow players to enable / disable their own PvP and to do PvP tournaments. Some code and images are from the PvP-Button Mod by Phiwari123.

Usage

PvP can be enabled/disabled from the inventory, or using the commands /pvp_enable and /pvp_disable.

A new tournament can be initiated by a player by typing /tournament. Then, each playing wanting to play in the tournament has to type /engage during the next minute (this delay is customizable using the pvpplus.tournament_starting_time setting, specified in seconds). Any engaged player can leave the current tournament by using /leave_tournament.
Varions infos about the current tournament can be seen using /tournament_info.

Some additional commands are only executable by the players possessing the tournament_mod privilege:

  • /start_global_tournament: immediately starts a tournament engaging every connected players (except those who don't have the interact privilege)
  • /stop_tournament: stops the current tournament
  • /remove_from_tournament <name>: removes a player from the current tournament
  • /add_to_tournament <name>: adds a player to the current tournament

Settings

  • pvpplus.enable_sound_loop = true: whether to play a looped epic music during the tournament

API

-- Enabling/disabling PvP:
pvpplus.pvp_set(player_name, state)
pvpplus.pvp_enable(player_name)
pvpplus.pvp_disable(player_name)
pvpplus.pvp_toggle(player_name)
pvpplus.is_pvp(player_name)

-- PvP tournaments:
pvpplus.engage_player(player_name) -- Engage a player for the next tournament
pvpplus.is_engaged(player_name) -- Is this player engaged for the next tournament ?
pvpplus.is_engaging_players() -- Is there an open tournament ?
pvpplus.start_tournament(starter_name) -- Start a tournament (at least 2 players have to be engaged)
pvpplus.start_global_tournament(starter_name) -- Start a tournament engaging every connected players
pvpplus.stop_tournament() -- Stop the current tournament
pvpplus.allow_engaging(starter_name, teleport) -- Allow players to engage themselves by typing /engage. Teleport is a Boolean
pvpplus.teleport_engaged_players() -- Teleport engaged players to the tournament position (only works if allow_engaging was called with teleport = true). Players who engage after this function has been run and before the tournament starts will be immediately teleported.
pvpplus.remove_from_tournament(player_name) -- Remove a player from the current tournament
pvpplus.add_to_tournament(player_name) -- Add a player to the current tournament
pvpplus.is_playing_tournament(player_name) -- Is this player playing in the current tournament ?
pvpplus.get_tournament_players() -- Return tournament players, engaged players or nil, depending on the tournament state
pvpplus.is_running_tournament() -- Is there a tournament currently running ?
pvpplus.get_score(player_name) -- Returns the player current score

-- Tournaments HUD:
pvpplus.tournament_hud_update_list() -- Updates the player list, as shown in the HUD
pvpplus.tournament_hud_update(player[, update_list]) -- Updates a player HUD, optionnaly updating the list (the default for update_list is true)
pvpplus.tournament_hud_update_all() -- Update the list and all player HUDs

TODO

  • Add a formspec for managing tournaments, accessible from the inventory
  • Testing

Sounds credits

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.