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.