Custom Player Models - Christmas Edition!

**alex** · November 8, 2025

Custom Player Models - Christmas Edition Documentation

📋 About Plugin

Name: Custom Player Models (Christmas Edition)
Version: 2.2.0
Author: steams.ro
Compatibility: AMX Mod X 1.8.2+, Counter-Strike 1.6

Description

Plugin that allows players to choose custom skins based on team (CT/T) and gender (boys/girls). Access to skins is controlled through separate lists for girls and boys. This Christmas Edition uses Santa and Grinch models as default skins for players not in any list, with an easy toggle system.

🎯 Features

✅ Separate list system - girls.ini and boys.ini
✅ 5 skins for each category - CT and T
✅ Interactive menu - /skin or /skins command in chat
✅ Instant skin application - Changes apply immediately when alive
✅ Conflict detection - players in both lists get default skins
✅ Automatic file creation - .ini files are created automatically if missing
✅ Multiple identification - support for Name and SteamID
🎅 Christmas toggle - Easy ON/OFF for Santa & Grinch default skins

🎄 What's Different in Christmas Edition?

Standard Version (v2.0.0):

Players not in lists → CS 1.6 default skins (arctic, guerilla, leet, etc.)
Requires 20 models total
No Christmas features

Christmas Edition (v2.2.0):

Players not in lists → Santa (CT) and Grinch (T) OR CS defaults (toggleable)
Requires 22 models total (20 custom + 2 Christmas)
Instant skin application when alive
CVAR toggle - christmas 0/1 to enable/disable themed defaults
Perfect for holiday servers or themed events

📦 Installation

1. Compile Plugin

amxxpc custom_player_models.sma

2. Copy Files

addons/amxmodx/plugins/custom_player_models.amxx
addons/amxmodx/configs/girls.ini (created automatically)
addons/amxmodx/configs/boys.ini (created automatically)

3. Enable Plugin

Add to addons/amxmodx/configs/plugins.ini:

custom_player_models.amxx

4. Configure CVAR (Optional)

Add to addons/amxmodx/configs/amxx.cfg:

christmas 1  // 1 = Santa/Grinch ON, 0 = CS defaults (default is 0)

5. Install Models

Copy all models in the correct structure (see below).

📁 Required Model Structure

Boys Models (10 models)

cstrike/models/player/boy_ct_1/boy_ct_1.mdl
cstrike/models/player/boy_ct_2/boy_ct_2.mdl
cstrike/models/player/boy_ct_3/boy_ct_3.mdl
cstrike/models/player/boy_ct_4/boy_ct_4.mdl
cstrike/models/player/boy_ct_5/boy_ct_5.mdl

cstrike/models/player/boy_t_1/boy_t_1.mdl
cstrike/models/player/boy_t_2/boy_t_2.mdl
cstrike/models/player/boy_t_3/boy_t_3.mdl
cstrike/models/player/boy_t_4/boy_t_4.mdl
cstrike/models/player/boy_t_5/boy_t_5.mdl

Girls Models (10 models)

cstrike/models/player/girl_ct_1/girl_ct_1.mdl
cstrike/models/player/girl_ct_2/girl_ct_2.mdl
cstrike/models/player/girl_ct_3/girl_ct_3.mdl
cstrike/models/player/girl_ct_4/girl_ct_4.mdl
cstrike/models/player/girl_ct_5/girl_ct_5.mdl

cstrike/models/player/girl_t_1/girl_t_1.mdl
cstrike/models/player/girl_t_2/girl_t_2.mdl
cstrike/models/player/girl_t_3/girl_t_3.mdl
cstrike/models/player/girl_t_4/girl_t_4.mdl
cstrike/models/player/girl_t_5/girl_t_5.mdl

🎅 Christmas Default Models (2 models) - REQUIRED!

cstrike/models/player/santa25xmas/santa25xmas.mdl
cstrike/models/player/grinch14xmas/grinch14xmas.mdl

IMPORTANT:

Each folder must also contain the .t file (texture) if the model uses it!
The Christmas models are REQUIRED - server won't start without them!
Even if christmas 0, the models must exist on server

Complete example:

models/player/santa25xmas/
├── santa25xmas.mdl
└── santa25xmas.t (optional, if exists)

Total Models Required: 22

10 boys models
10 girls models
2 Christmas default models

⚙️ Configuration

CVAR Settings

Add to addons/amxmodx/configs/amxx.cfg:

// Christmas skins toggle
christmas 1  // 0 = OFF (CS defaults), 1 = ON (Santa/Grinch)

Default: christmas 0 (OFF - CS default skins)

Behavior:

christmas 0 - Players not in lists get CS 1.6 default skins
christmas 1 - Players not in lists get Santa (CT) / Grinch (T)

To change during game:

// In server console or RCON
christmas 1
amx_cvar christmas 1

File: `girls.ini`

# ---[ Girls List ] --- #
# -> Syntax : "Name/Steam Id"
# -> Example : "PlayerName"

"STEAM_0:1:12345678"
"Maria"
"Ana_Gaming"

File: `boys.ini`

# ---[ Boys List ] --- #
# -> Syntax : "Name/Steam Id"
# -> Example : "PlayerName"

"STEAM_0:0:87654321"
"John"
"ProPlayer123"

Adding Rules:

✅ You can use player name or SteamID
✅ Put each entry in quotes: "Name"
✅ One entry per line
✅ Lines starting with # or ; are comments
⚠️ Names are case-sensitive (Maria ≠ maria)

🎮 Usage

For Players

Commands:

/skin   - Opens skin selection menu
/skins  - Opens skin selection menu (same as /skin)

Both commands do the same thing - open the interactive menu!

How It Works:

On connect - you receive a message if you have access to skins
Type /skin or /skins - menu opens with 5 options
Choose skin - press corresponding key (1-5)
If alive - skin changes instantly!
If dead - skin will change on next spawn
Default users - get Santa (CT) or Grinch (T) if christmas 1, or CS defaults if christmas 0

Example Messages:

[Skins] You have access to custom skins! Type /skin or /skins for menu.
[Skins] Skin 3 applied instantly!
[Skins] Skin 2 selected! You will get it on next spawn.
[Skins] You don't have access to custom skins!
[Skins] You are in both lists! You will get the default skin.

🔧 For Administrators

Toggle Christmas Skins

Method 1 - Config File (Permanent): Edit addons/amxmodx/configs/amxx.cfg:

christmas 1  // Enable Santa/Grinch

Method 2 - Console (Temporary):

christmas 1  // Enable
christmas 0  // Disable

Method 3 - RCON:

rcon christmas 1

Adding Players

Method 1 - Manual:

# Edit .ini files directly
nano addons/amxmodx/configs/girls.ini

Method 2 - Through Server:

# Stop server
# Edit files
# Restart server OR reload map

Reload Lists

To reload lists without restart:

amx_map de_dust2  (or any map)

Console Verification

After server start, check:

[CUSTOM-MODELS] Loaded X girls
[CUSTOM-MODELS] Loaded Y boys

To check CVAR status:

christmas

Troubleshooting

❌ Error: "Model santa25xmas not found"

Cause: Christmas default model is missing
Solution: Install santa25xmas.mdl and grinch14xmas.mdl in correct folders

❌ Error: "Model boy_ct_1 not found"

Cause: Model is missing from correct folder
Solution: Verify all 22 models are in the correct location

❌ Christmas skins not working

Possible causes:

christmas 0 in config (check with christmas command)
Models santa25xmas/grinch14xmas are missing
Plugin not loaded properly

Solution:

christmas 1  // Enable in console
amx_map de_dust2  // Reload map

❌ Player doesn't receive custom skin

Possible causes:

Not in girls.ini or boys.ini (will get defaults)
Name/SteamID is misspelled
In both lists (conflict - gets defaults)
Selected model is missing

❌ Menu doesn't open

Cause: Player doesn't have access (not in lists)
Note: This is normal - only listed players can choose custom skins

❌ Skin doesn't change instantly

Possible causes:

Player is dead (will apply on spawn - this is normal)
Model file is missing
Plugin conflict with another skin plugin

📊 Behavior

Skin Priority:

In girls.ini AND boys.ini → Default skins (conflict)
In girls.ini → Skins girl_ct_X / girl_t_X
In boys.ini → Skins boy_ct_X / boy_t_X
In no list → Based on christmas CVAR:
- christmas 1 → Santa (CT) / Grinch (T) 🎅
- christmas 0 → CS default skins

On Connect:

Selected skin resets to Skin 1 (first model)
Player must choose again with /skin or /skins
Non-listed players automatically get default skins based on CVAR

On Spawn:

Automatically applies selected skin
If you switch team (CT↔T), you get the corresponding model
Non-listed players: Based on christmas CVAR setting

When Alive:

Selecting a skin from menu applies it instantly
No need to wait for respawn!

🎨 Customization

Change Christmas Models

In code, modify these lines:

new const SANTA_MODEL[] = "santa25xmas";
new const GRINCH_MODEL[] = "grinch14xmas";

Example: For different Christmas models:

new const SANTA_MODEL[] = "my_custom_santa";
new const GRINCH_MODEL[] = "my_custom_grinch";

Change Number of Skins

In code, modify the line:

#define MAX_MODELS 5

Example: For 10 skins per category:

#define MAX_MODELS 10

WARNING: You must have all models (boy_ct_1 through boy_ct_10, etc.)

Change Commands

In code, modify:

register_clcmd("say /skins", "CMD_SkinsMenu");
register_clcmd("say /skin", "CMD_SkinsMenu");

Example: For /models:

register_clcmd("say /models", "CMD_SkinsMenu");

Change CVAR Name

In code, modify:

g_christmas_skins = register_cvar("christmas", "0");

Example: For xmas_mode:

g_christmas_skins = register_cvar("xmas_mode", "0");

Change Messages

Search in code for [Skins] and modify texts:

client_print(id, print_chat, "[Skins] Your custom message here");

📝 Usage Examples

Example 1: Year-Round Server

# amxx.cfg
christmas 0  # Use CS defaults most of the time

# During December, change to:
christmas 1  # Enable festive atmosphere!

Example 2: Always Festive

# amxx.cfg
christmas 1  # Always use Santa/Grinch for non-VIP

# girls.ini & boys.ini - VIP members
"VIP_Member1"
"VIP_Member2"

Example 3: Mixed Community

# Some players get custom models
# Regular players can enjoy either CS classics or Christmas theme
# Admin controls with simple CVAR toggle

❓ Frequently Asked Questions (FAQ)

Q: Can I use names with spaces?
A: Yes! Example: "Name With Spaces"

Q: What happens if I'm not in any list?
A: You get Santa/Grinch if christmas 1, or CS defaults if christmas 0.

Q: Can I change skins while alive?
A: Yes! The skin changes instantly when you select from menu.

Q: Do I need Christmas models if I set christmas 0?
A: Yes! The models must exist on server even if not used. This is required for plugin startup.

Q: Can I have more than 5 skins?
A: Yes, modify #define MAX_MODELS and add the models.

Q: Is the skin saved between reconnects?
A: No, on each connect you start with Skin 1.

Q: Can I change the Christmas models to other themes?
A: Yes, modify the SANTA_MODEL and GRINCH_MODEL constants in code and use your own models.

Q: What happens if a model is missing?
A: Server won't start and shows error in console.

Q: Can I temporarily disable the plugin?
A: Yes, comment the line in plugins.ini with // or ;

Q: How do I switch between Christmas and normal mode?
A: Simply change christmas CVAR: christmas 1 for Santa/Grinch, christmas 0 for CS defaults.

🆚 Version Comparison

Feature	Standard v2.0.0	Christmas v2.2.0
Custom skins (boys/girls)	✅	✅
Menu system	✅	✅
Instant skin change	❌	✅
Default skins	CS 1.6 only	Toggle: CS or Christmas
CVAR control	❌	✅ `christmas`
Total models	20	22
Best for	Year-round simple	Flexible + themed
Commands	`/skins` only	`/skin` + `/skins`

Choose based on:

Standard: Basic functionality, CS defaults only
Christmas: Advanced features, instant change, toggleable themes

🐛 Bug Reporting

For bugs or suggestions, contact:

Website: steams.ro
Check: AMX Mod X version and CS 1.6
Include: Console logs and reproduction steps

📜 License & Credits

Developed by: steams.ro
Version: 2.2.0 (Christmas Edition)
Date: November 07, 2025

Free plugin for Counter-Strike community.

Model Credits

Custom models: By respective creators
Santa/Grinch models: Ensure you have proper rights to use these models

🔄 Changelog

v2.2.0 - Christmas Edition (November 07, 2025)

✨ Added instant skin application when alive
✨ Added /skin command (same as /skins)
🎅 Added christmas CVAR for easy toggle (default: OFF)
🎄 Santa/Grinch can now be disabled via CVAR
💬 Improved player feedback messages
🔧 Simplified CVAR name from christmas_skins to christmas

v2.1.0 - Christmas Edition (November 07, 2025)

🎅 Added Santa model as CT default
🎄 Added Grinch model as T default
✨ All features from v2.0.0 included

v2.0.0 (November 07, 2025)

✨ Complete interactive menu system
✨ Support for 5 skins per category
✨ /skins command in chat
✨ Automatic conflict detection
✨ Informative messages for players

v1.0.0 (Original)

🎉 Initial version with fixed skins
📁 girls.ini/boys.ini list system

Happy Holidays and thank you for using Custom Player Models - Christmas Edition! 🎅🎄🎮

Quick Setup:

Install 22 models
Add christmas 1 to amxx.cfg (optional, default is 0)
Add players to girls.ini/boys.ini
Players use /skin to choose!
Toggle festive mode anytime with christmas CVAR!

models.zip

custom_player_models.amxx custom_player_models.sma

Sign In

Custom Player Models - Christmas Edition!

Recommended Posts

alex

Custom Player Models - Christmas Edition Documentation

📋 About Plugin

Description

🎯 Features

🎄 What's Different in Christmas Edition?

Standard Version (v2.0.0):

Christmas Edition (v2.2.0):

📦 Installation

1. Compile Plugin

2. Copy Files

3. Enable Plugin

4. Configure CVAR (Optional)

5. Install Models

📁 Required Model Structure

Boys Models (10 models)

Girls Models (10 models)

🎅 Christmas Default Models (2 models) - REQUIRED!

⚙️ Configuration

CVAR Settings

File: girls.ini

File: boys.ini

Adding Rules:

🎮 Usage

For Players

Commands:

How It Works:

Example Messages:

🔧 For Administrators

Toggle Christmas Skins

Adding Players

Reload Lists

Console Verification

Troubleshooting

❌ Error: "Model santa25xmas not found"

❌ Error: "Model boy_ct_1 not found"

❌ Christmas skins not working

❌ Player doesn't receive custom skin

❌ Menu doesn't open

❌ Skin doesn't change instantly

📊 Behavior

Skin Priority:

On Connect:

On Spawn:

When Alive:

🎨 Customization

Change Christmas Models

Change Number of Skins

Change Commands

Change CVAR Name

Change Messages

📝 Usage Examples

Example 1: Year-Round Server

Example 2: Always Festive

Example 3: Mixed Community

❓ Frequently Asked Questions (FAQ)

🆚 Version Comparison

🐛 Bug Reporting

📜 License & Credits

Model Credits

🔄 Changelog

v2.2.0 - Christmas Edition (November 07, 2025)

v2.1.0 - Christmas Edition (November 07, 2025)

v2.0.0 (November 07, 2025)

v1.0.0 (Original)

Browse

Activity

File: `girls.ini`

File: `boys.ini`