README

Visit our Discord / Homepage / Store !

---

Requirements / Dependencies

The following resources are required for nss_block_weapons to work:

• nss_libs

• Vorp Framework

---

Changelog

See CHANGELOG.md for more information.

---

Features

• Block using weapons for a specific time after respawn from death.

• Persistent blocking time for offline characters (until server or resource restart).

• Completely configurable:

  • Configure block time.

  • Configure notification texts (in your own language).

  • Configure notification icons.

  • Enable status indicator with progress bar.

  • Configure status indicator style via config file.

  • Status indicator icon is replaceable (transparent png file).

  • Configure debug mode.

• Good performance on server and client side.

• And more...

---

Open ToDo's

• Nothing ;)

---

Known issues

• Currently, no known issues.

---

Setup script

1. Ensure that the nss_block_weapons folder is in your resources folder.

2. Rename config.demo.lua to config.lua and fill in the values.

3. Add ensure nss_block_weapons to your server.cfg.

4. Restart your server.

---

Commands

[xyz] is required, (abc) is optional.

Admin commands

Only available for players with admin permissions.

• block_weapon_show_dazed_players - Shows all players who are currently blocked from using weapons.

• block_weapon_daze_player [player_id] (duration_in_seconds) - Blocks the given player from using weapons for the given duration (in seconds). If no duration is given, the default duration from the config will be used.

• block_weapon_undaze_player [player_id] - Unblocks the given player from using weapons.

• block_weapon_daze_all_players (duration_in_seconds) - Blocks all players from using weapons for the given duration (in seconds). If no duration is given, the default duration from the config will be used.

• block_weapon_undaze_all_players - Unblocks all players from using weapons.

Debug mode commands

Only available if debug mode is enabled in the configuration.

For testing with yourself:

• block_weapon_show_block_message

• block_weapon_show_unblock_message

• block_weapon_show_try_blocking_message

• block_weapon_add_ammo

• block_weapon [duration_in_seconds] duration_in_seconds is optional

• unblock_weapon

Test the notifications:

• block_weapon_show_block_message

• block_weapon_show_unblock_message

• block_weapon_show_try_blocking_message

---

FAQ

What happens if the player dies during the blocking time?

The blocking time resets and starts again from the beginning.

What happens if the player re-join the game during the blocking time?

The blocking time is persistent on the server and will not reset.

What happens if I restart the server or the resource during the blocking time?

All blocking times will be reset.

Can a doctor stop the blocking time?

Currently, no.