GhostEntity: High-Performance Map Decor - Script
GhostEntity is the addon for enriching your Gmod maps with high-performance decorations. Thanks to optimized resource management, it lets you place thousands of elements without impacting the server or overloading the network. Its intelligent system delegates rendering to the client, reducing CPU, GPU and bandwidth load. With its intuitive interface and advanced features, GhostEntity transforms your environments without compromising on performance.
❮
❯
Description of GhostEntity: High-Performance Map Decor
Table of Contents:- 📘 Description of "GhostEntity: Gmod's High-Performance Map Decor Addon"
- 🚀 Why Use the Gmod GhostEntity Map Decor Addon?
- ⚙️ The GhostEntity Addon Management Menu
- 🛠️ The SWEP (GhostEntities Tool)
- 💪 How it Optimizes the CPU, Server Bandwidth, and Client GPU?
- ⚡ Addon File Sizes
📘 Description of "GhostEntity: Gmod's High-Performance Map Decor Addon"
GhostEntity is an addon for Gmod, designed to transform the way you decorate your maps. Thanks to its unique and ultra-optimized system, it allows you to place decorations without any performance loss for your server. You can go all out with the quantity without worrying (see the stress test video demonstrating how to place 8000 decoration entities without jeopardizing your Gmod server's resources) while maintaining exceptional performance.
Here’s why GhostEntity is a must-have for any GMod creator or server admin:
1. Lightweight on download: With a minimal file size, GhostEntity doesn’t overload your players when they join your server.
2. Intuitive and comprehensive interface: The management menu is easy to use, even for non-programmers.
3. Model library management panel: Easily manage your 3D model collection by adding new items. These models will then be available in the included tool menu, allowing you to place them directly on your map.
4. Simplified database management: Delete or modify your objects directly from the integrated database or using the dedicated tool (GhostEntity Tool).
5. Advanced display distance customization: Configure individually the distance at which each model becomes visible. For example, decorative objects like grass don’t need to be displayed at long distances, saving resources.
6. Control over the physical properties of objects: You can enable/disable physics for purely visual objects (like plants), reducing server load and optimizing NPC interactions (objects that don’t exist for them aren’t taken into account in their search fields).
7. Real-time enrichment: Easily add new 3D models to your library and continue building your decorations, even while players are exploring or playing on your server.
8. Overview with built-in ESP: The integrated ESP (Extra Sensory Perception) gives you an overall view of your GhostEntities, making management and organization easier.
With GhostEntity, you no longer have to compromise server performance to make your maps vibrant and immersive. It's perfect for transforming your environments into rich and captivating spaces, without technical constraints.
🚀 Why use the Gmod GhostEntity Map Decor addon?
GhostEntity is the ideal solution to enrich your maps with a variety of decorations, whether for general visual improvements or events like Halloween and Christmas. Unlike classic props and perma props, which require constant synchronization between the server and clients, GhostEntity works intelligently by limiting the load on the server. Data is cached on the client side upon connection, eliminating additional network and CPU processing. Furthermore, since GhostEntities exist only on the client side, they bypass the 8000 entity limit of a Gmod server while optimizing rendering with dynamic distance management.
You can place thousands of decorative items without compromising performance, offering a smooth and enjoyable experience for your players. With GhostEntity, transform your maps without technical constraints!
⚙️ The Management Menu of the GhostEntity Addon
You can:
The GhostEntity management menu allows you to control and customize your decorations in a simple and intuitive way. Accessible via the command indicated in the wiki, this menu offers several practical features:
Model Library: Access the library of models you’ve added to the system and use them directly from the included tool to create your decorations.
GhostEntity Management: View all the GhostEntities placed on the map, delete them, or teleport to their position with one click.
Modules Menu:
- Enable or disable decorations in real-time with a simple ON / OFF button.
- Configure the default display distance.
- Enable ESP for an overview of the GhostEntities.
- Limit the maximum number of GhostEntities (10,000 by default) and entities with physics (limited to 4,000 by default). Even if they have physics, they cannot be manipulated with the standard physgun.
SWEP (GhostEntity Tool): A convenient button at the top right allows you to easily give yourself the SWEP to create, delete, and place your decorations.
With this menu, you benefit from a smooth and fully customizable management system to optimize your map decoration experience in Gmod.
🛠️ The SWEP (GhostEntities Tool)
The GhostEntities Tool SWEP is the main tool for creating and managing your decorations in Gmod. Once the tool is in hand, press the Reload key to open its menu, where you’ll find two main sections:
On the left: The list of available models, organized by category, which you can customize to your needs.
On the right: The tool’s options and modes (ON / OFF), with the following main features:
Build Mode: Activate this mode to place GhostEntities on the map.
Remover Mode: Use this mode to delete GhostEntities (note that Gmod's Toolgun doesn’t work on non-existent entities).
Add Target Model Mode: Quickly add the model you’re aiming at to your library, ideal if you don’t want to add it manually via the panel.
Auto Click: Allows you to hold the left click to mass add or remove entities.
Add Collisions: Add collisions to a GhostEntity so that it doesn’t interfere with in-game objects while remaining non-networked, preventing it from passing through walls or invisible barriers.
Random Rotation (Yaw): This option randomly changes the rotation of entities each time they spawn, perfect for objects like vegetation (e.g., ferns), making the placement more natural.
45° Step: When placing, it allows you to adjust the angle of the entity in 45° increments, useful for precise alignment, especially in specific configurations.
Material Wired: Displays the model's angles before placing it, to help with visual alignment.
Material Transparent: Allows you to see the model in transparent mode before placing it, making space management easier.
ESP: Activate ESP to easily view entities without accessing the menu.
ESP Distance: Displays the distance of the selected entity, useful for adjusting model display distances.
The GhostEntities Tool is a comprehensive and powerful tool designed to make the placement of your decorations in Gmod fast, flexible, and perfectly optimized.
💪 How it optimizes CPU, bandwidth on a Gmod server, and also the client GPU?
1. Server-side CPU Optimization:
- No real-time management of GhostEntities. Unlike classic props and Perma Props, GhostEntity does not generate any physical entities on the server.
This means no CPU cycles are used to process physics or server-side logic.
GhostEntities are not included in NPC-related calculations, reducing the load during server-NPC interactions.
- Reduction of Network Processing related to PVS (Potentially Visible Set): In a traditional system, visible entities are recalculated based on player movement through areas of the map. GhostEntity does not depend on PVS since entities are purely client-side. This eliminates the processing overhead related to visibility updates and unnecessary cycles to synchronize entities between the server and clients.
2. Bandwidth Optimization:
- No Continuous Network Traffic with GhostEntities: When a player joins the server, the data for the GhostEntities (positions, models, configurations) is sent once and cached on the client.
Decorative entities are not dynamically synchronized via the network, which:
- Significantly reduces bandwidth usage.
- Improves server stability by decreasing the risk of network overload.
- Data Compression: The information necessary for GhostEntities is minimized in size through optimized data structures, ensuring transfers remain lightweight even with a large number of entities.
3. Client-side GPU Optimization:
- Display Distance Management: Each GhostEntity can be configured to only appear at a certain distance, which:
- Reduces the number of entities rendered by the graphics engine when the player moves far away.
- Lightens the GPU load, especially in densely decorated areas.
- Use of Static Entities: GhostEntities, having no physics on the client side, are rendered as static objects, reducing the load on the physics engine.
- Disabling Unnecessary Collisions: GhostEntities configured without collisions have no impact on the physics engine's collision calculations.
This improves GPU performance and also reduces the CPU processing required on the client side to handle physical interactions.
4. Reduction of the Total Number of Entities:
GhostEntities are not recorded as physical or scripted entities on the server, allowing you to easily exceed the 8,000 entity limit imposed by Gmod.
5. Overall Optimization Process:
- Entity Creation: When a GhostEntity is placed, its data is immediately stored in a centralized server-side database and shared with connected clients.
- Client Loading: Data is sent to the client only when they connect or during decoration construction if the player is already connected.
- Client-side Rendering: GhostEntities are fully managed by the client, with optimizations to minimize GPU and memory consumption through efficient calculations.
[/b]Conclusion:[/b] GhostEntity optimizes overall performance by offloading almost all entity management to the client, freeing up the server to focus on critical tasks. It’s a perfect system for maximizing smoothness while allowing massive map customization.
⚡ Addon File Sizes
Addon File Sizes:
- Client (Lua): 44 KB
- Server (Lua): 13 KB
- Configuration (Lua): 5 KB
- Workshop (Material): Only 3.8 KB
Path: garrysmod/addons/norda_ghostentity
- The AddWorkshop function is automatically added to the script server file and can be deactivated from the configuration file. : resource.AddWorkshop( 3415599200 )
- To add gmod workshop resources to your collection : GhostEntity: High-Performance Map Decor [Content Only] | Gmod Workshop
1. From the console: norda_ghostent_menu
2. If you don't like commands, you can open it from the Nor Admin Mod (Gmod Admin System) menu.
3. From the Reload menu of GhostEntity Tool, click on the wheel in the top right-hand corner.
2. Or from the management menu, click on the little ghost in the top right-hand corner.
1. Copy the template path to the template library from the management menu.
2. With the Swep: GhostEntity tool. Activate Get Model mode from the tool's Reload menu and click on an entity, or a props, its model will be automatically added to the library, and you'll receive a notification.
It will then appear in the tool's reload menu, which you can use immediately.
Translated with DeepL.com (free version)
This allows you to organize the tool's menu, reducing categories and displaying only what you need at the moment of use.
cfg.Categories={
"No Category",
"Foliage",
"Debris",
"Stone",
"Garbage",
"Horror",
"Misc"
}
All changes are made in real time.
1. From the modules menu (the third tab of the management menu), click ON on the relevant line.
2. From the tool's reload menu. Click ON on the relevant line.
You'll then see all the positions where you've placed a ghostentity on your server map.
You can display the ID or distance in meters below.
In this menu, you'll see the templates you've added to your library, sorted by category. Select one and the ghost you place will take that shape.
On the right, you'll see the different modes that can be activated: ON / OFF
1. Construction mode.
Hold down the click + USE to manipulate the angle. (Shift pressed to rotate 45°)
Hold down the click + JUMP to raise the position.
Hold down the click + CROUCH to move down.
Release to finish positioning. A Ghostentity will be placed.
2. Remover mode allows you to permanently remove a Ghostentity you have placed. Activating ESP can help you remove it.
3. Target Model mode lets you add models of targeted entities directly to the library.
4. Auto Click mode: allows you to spam, set or delete without releasing the click.
This means that an entity that is not shared on the network is created on the server side, network optimization is still effective, but an offline entity exists on the server side, invisible and in the same position as its ghostentity. This entity transmits nothing, but the player will be confronted with the collision you wanted.
Note: This kind of approach with a collision means that the entity exists on the server side and is therefore subject to the server-side entity limitation rule on Gmod. Try not to exceed 8000 in total, including what you've already put on your server.
Tip to avoid the leak of GhostEntity: High-Performance Map Decor installed on your Garry's Mod server: How avoid the Leak of your Gmod scripts
How Install an addon on Gmod? : How install an addon on Gmod
How Publish an addon on the Gmod workshop? : Documentation how create a content pack to publish on the workshop?
Creator: Norda Scripts
| Sales | 3 |
| Published | 1 day |
| Last update | |
| Version | version 1.0 |
| DRM | Yes |
| Categories | Gmod addons |
| Requierements | Garry's Mod Server |
| Languages | 🇬🇧 🇫🇷 |
| Optimisation Management Allgamemode Map Standalone | |