NRestrict: Advanced & Optimised GMod zone restriction addon - Script

Description of NRestrict: Advanced & Optimised GMod zone restriction addon

1. ⛔ Description of "NRestrict: Advanced and Optimized Zone-Based Access Restriction for GMod"
2. 💡 Why integrate NRestrict into your server?
3. ⚙️ NRestrict Menu: Centralized Management of Zone Restrictions
4. 🧰 Integrated SWEP: Create and Configure Restriction Zones Without Entities
5. 👁️ Feedback HUD: Dynamic Display of Restriction Reasons
6. 📜 Access Condition Configuration: Groups, Ranks, Jobs, Levels
7. 🔐 Whitelist, Blacklist, and Hierarchical Management
8. 🚧 Anti-Abuse & Behavioral Security
9. ⚡ Performance & Client/Server Architecture
10. 🚀 Compatibility with the OSGMod Ecosystem

NRestrict is a zone-based access restriction system for Garry's Mod, designed for demanding and modular environments. Built on a smart client/server architecture, it allows precise control over who can enter a zone based on multiple criteria: job, job group, role, level, rank, category, etc. all without placing entities in-game or relying on a gamemode.

Designed for RP servers DarkRP, Helix, or Sandbox NRestrict acts like a logical firewall: zones can be configured to allow or deny certain entities in real-time, with a clear user notification on the HUD when access is automatically denied.

When a player enters a zone, the system dynamically analyzes their profile (job, role, level) and displays a HUD notification if access is denied, clearly indicating the reason: insufficient level, unauthorized job, etc. All this works without ongoing network sync or global loops, ensuring minimal system impact.

Where staff typically must intervene manually to block access to sensitive areas (VIP district, faction zone, command room, etc.), NRestrict serves as an automated, reliable replacement. Comparable to tools like Area Restrictor 2, it offers a more modular, optimized, and fully customizable approach.

In the absence of moderators, or within demanding RP settings, NRestrict maintains order, immersion, and access hierarchy without human intervention. Whether restricting access to police, medics, armed factions, or specific levels, the system acts automatically and transparently to users without server overhead.

Is NRestrict the sequel to Gmod Area Restrictor?
Yes, NRestrict is the direct evolution of Gmod Area Restrictor, an addon I created over 10 years ago.
In a way, it's "Area Restrictor 2", redesigned from the ground up to meet the needs of today's GMod servers.

🧠 Fun fact: a tenth of a century (yes, 10 years) passed between my two addon generations.
Meanwhile, some folks sell you a "remaster" just 4 months after their first draft... Goes to show: between remaking quickly and remaking properly, there's a decade's difference. 😉

✅ Zero entities to place on the map.
✅ Spherical or cubic zones.
✅ Whitelist & blacklist within the same zone.
✅ Dynamic analysis: role, level, job, category.
✅ HUD display of restriction reason.
✅ Centralized management menu.
✅ Compatible with DarkRP, Sandbox, NJob, Helix.
✅ Integrated SWEP for fast creation/editing.
✅ Optimized for massive multiplayer (128+ players).
✅ No global hooks or intensive loops.
✅ Zones can be created "outside map" perfect against noclip abuse.
✅ No map reload required.

Via an ergonomic interface, configure all your restriction zones with pinpoint accuracy. The menu allows:
- Creation of restricted job groups, categories, or roles.
- Assigning minimum or maximum allowed levels.
- Defining zones open only to certain ranks (e.g., staff, faction, VIP).
- Choosing between whitelist, blacklist, or both.
- Customizing HUD messages shown upon restriction.

Designed for complex server management, the system enables total control without manual in-map interactions.

The integrated SWEP allows for fast, intuitive zone creation:
- Reload: open the SWEP interface.
- Left click: set Point P1 (center or corner).
- Right click: set Point P2 (radius or opposite corner).
- Left click on existing zone: move it.
- Right click on existing zone: delete it.
- No physical entity needed. Configuration is 100% dynamic and instant.

When a player tries to enter a restricted zone:
- A HUD notification is automatically displayed.
- The exact restriction reason is shown (e.g., "Access Denied: Level 15 Required", "Unauthorized Job: Police").
- Optional logo, text, sound, and color customization.
- Optional denial messages in chat.
- This ensures a clear user experience and avoids RP confusion.

Each zone can be conditioned based on:
- A whitelist of authorized jobs.
- A blacklist of roles, groups, or jobs.
- A minimum or maximum level (compatible with progression addons).
- A specific rank (VIP, staff, faction, etc.).
- An entire category of jobs.

All parameters are configurable per zone, with options to duplicate restriction profiles.

At its core, the system uses advanced hierarchical management:
- A priority whitelist can allow specific players even if blacklisted.
- Hierarchical groups (staff, admin, superadmin) can be set as override.
- Predefined access profiles can be saved for fast reuse (VIP zones, military, rebels, etc.).
- A powerful logic system allows management of dozens of zones with ease.

To prevent bypass attempts:

- Optional physical block at entry: player is pushed back.
- Logical block: entry allowed but actions (firing, interaction, etc.) disabled.
- Automatic admin notifications if bypass attempts occur.
- Access attempt history logged.
- Built-in security no external dependency.

Optimized footprint:
Client: ~41ko
Serveur: ~14ko
Workshop (icons): ~7ko

Architecture:
- No global hooks.
- No ongoing server loops.
- No entities placed on the map.
- Localized processing with event-driven triggers.

Supports up to 128 simultaneous players without latency even with hundreds of active zones.

NRestrict integrates naturally with its addons, which are not mandatory:
💪 Gmod Leveling System: If you don't have a leveling system and want to limit zones according to minimum and maximum levels required.
🎭 Gmod Karma + Reputation System: If you need to add zone limits based on a player's reputation.
💼 NJob - Gmod Job Creator and Editor: If you don't want to use DarkRP, NJob adds a job system compatible without DarkRP.
🛠️ Nor Admin Mod - GMod Administration System: If you want to add special roles, VIPs or other roles in Whitelist.