minetest-mod-antipvp/README.md

minetest mod pvpinvul
=====================

Provides pvp invulnerability to players by privilegie.

Information
-----------

This mod is named `pvpinvul` and add a priv that give PvP(Player vs Player) invulnerability.

![screenshot.png](screenshot.png)


## tech information

This is a fork from original https://notabug.org/gnuhacker/pvpinvul if still exits.

Main difference are:

* the message event is configurable so it doesn't flood the chat for every hit 
on multiple attacks (to all players or only involved)
* It provides backguard compatibility and stability for older engines, so 
we avoid the pain of upgrades with stupids reasons by developers

It provides a way to grant pvp god privilegies agains pvp(Player vs Player) battles:

`/grant <player> pvpinvul`

The `PVP` term means player versus player.

### Download

Can be downloaded from https://codeberg.org/minenux/minetest-mod-pvpinvul and 
must be named as `pvpinvul`.

Original work can be downloaded from https://notabug.org/gnuhacker/pvpinvul if still exits.


### Configuration

You can set those configurations in the mod tab at the gui, or added those option 
to the minetest config file at game directory, to the main global config file.

| config option | type | default | description |
| ------------- | ---- | ------- | ----------- |
| pvpinvul_kill_hitter | bool | false | if enable, players that hit will be killed. |
| pvpinvul_admin_privs | bool | true  | if enable, the admin of the server will be automaticaly with pvpinvul privilegies. |
| pvpinvul_send_to_all | bool | true  | if enable, when a hitter try to hurt to a invulnerable player, send the message to all players. |

For more info check https://codeberg.org/venenux/venenux-minetest/src/branch/master/tutorials/manage-minetest-configuration.md

## License

   Copyright (C) 2021 Sandro Del Toro De Ana
	
   Pvpinvul is free software: you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation, either version 3 of the License, or
   any later version.
	
   Pvpinvul is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.
	
   You should have received a copy of the GNU General Public License
   along with Pvpinvul.  If not, see <https://www.gnu.org/licenses/>.