Compressor – Model Replacement Framework for CS 1.6 & HL

Compressor is a powerful model replacement framework designed for AMX Mod X servers. It allows server operators to compress multiple model entries into a single file, overcoming the 510 model resource limit while maintaining full functionality.

With Compressor, you no longer need to unprecache shields or weapons—servers can now maintain full model functionality while saving precached slots.

Key Features

• Optimized Model Replacement: Automatically replaces models based on a configuration file.

• Preserves Functionality: Correctly sets body groups, skin groups, and colormaps.

• Automatic Precaching Management: Prevents original models from being precached.

• Game Agnostic: Works with any AMX Mod X-supported game if compressed models and configs are provided.

• Huge Slot Savings: Dramatically increases free precached model slots with minimal setup.

How it works:
When a configured model is requested:

1. Original model is prevented from precaching

2. Replacement entry is loaded from the config file

3. Body group, skin group, and colormap values are set automatically

Compatible Games

• Half-Life

• Counter-Strike 1.6

Additional games are supported if modders provide the compressed model files and corresponding configuration entries.

Configuration

1. Entities Configuration

The compressor_entities_[game].cfg file lists all weapon entities to monitor for p_ model replacements.

Example for CS 1.6 (compressor_entities_cstrike.cfg😞

Adding non-weapon entities may cause server crashes.

Replacements Configuration

The compressor_replacements_[game].cfg file maps original models to compressed replacements.

Example for CS 1.6 (compressor_replacements_cstrike.cfg😞

Format:

• Original model – Path to the model being replaced

• Replacement model – Path to the compressed model containing multiple submodels

• Submodel – Body group index in the compressed model

• Skingroup – Skin variation

• Colormap – Color mapping

Muzzleflash Configuration (Optional)

Some games like CS 1.6 define muzzleflash attachments in p_ models rather than player models. This config maps weapons to muzzleflash models.

Example (compressor_muzzleflashes_cstrike.cfg😞

Compiler Options

The plugin includes compiler directives:

API Reference

Forward Callbacks

• Triggered when Compressor replaces a model or a p_ model

Native Functions

• Changes an entity’s model while maintaining Compressor optimization

• Must be used for model changes to maintain compatibility

Incompatibilities

• BackWeapon Plugins (any version) & SideWeapons by SoulWeaver16

  • Compressor takes priority and hides back weapons

• Any plugin changing an entity’s model must use Compressor_SetModel()

  • Simple line replacement usually solves conflicts

Example:

Compressor is a release candidate. Tested in isolated environments, but not fully stress-tested in populated servers.

Requirements

• AMX Mod X 1.9+

• Compressed model files and configuration entries