﻿RandomSkins Global v4
Release Package — MASTER SAYED

PACKAGE CONTENTS
- CLEO/RandomSkins_v4_Global.cs: compiled CLEO script.
- IDE_Patch/RandomSkins_Global_v4_Peds_Addon.ide: additional ped definitions for IDs 19000–19255.
- IDE_Patch/Slot_Catalog.csv: slot and model-name catalog.
- Templates/CUSTOM_SKIN_TEMPLATE.txt: custom-skin example.
- README_AR.txt and README_EN.txt.

IMPORTANT
No DFF/TXD skin files are included. Players must supply their own character models.
This release uses IDs 19000–19255 only (256 slots). IDs 15000–15255 belong to an older version and are not used here.

INSTALLATION
1. Install a CLEO version compatible with your GTA San Andreas installation.
2. Copy RandomSkins_v4_Global.cs into the game's CLEO folder.
3. Back up your original data/maps/peds.ide.
4. Open the original peds.ide. Inside its peds section, add every line from:
   IDE_Patch/RandomSkins_Global_v4_Peds_Addon.ide
   Place the lines before the section's final 'end'.
5. Do not replace the complete original peds.ide with the add-on patch.
6. Install your own DFF/TXD files through the model-installation system used by your game (for example, your ModLoader setup). Their names must match the IDE model/TXD names.
7. Launch the game and test the models.

ADDING YOUR OWN SKINS — EXAMPLE
Choose slot 19027 and look it up in Slot_Catalog.csv.
If the model name is rs_example, the files must be:
rs_example.dff
rs_example.txd
The IDE model name and TXD name must match the two filenames exactly.
Do not change the slot ID; the script selects custom slots in the 19000–19255 range.

NOTES
- One model per slot. Do not duplicate an ID.
- Missing or incorrectly named DFF/TXD files can prevent a model from loading correctly.
- The rs_ names are fixed internal names in the supplied IDE definitions. Rename your model files to match them, or edit both ModelName and TxdName fields in that slot's IDE line to the same new name, then use that name for both files.
- Do not put DFF/TXD files in the CLEO folder. Install model files through your game's ped-model modding system.
- The supplied peds.ide file is an add-on patch only. Do not delete the game's original definitions.
- According to the source script comment, slot 19141 is skipped and mapped to 19140. Do not use 19141 for a separate custom character in this release.
- The script selects from 256 custom slots plus the original game-skin list. It does not mean all 512 selections are custom skins.

CONTROLS (from the supplied source)
- F9: restore CJ's original appearance.
- F10: toggle government peds mode.
- F11: give CJ a random skin.
- F12: change up to 60 loaded peds except CJ; cooldown is approximately 20 seconds.
- Numpad /: switch between RandomSkins skins and the original game-skin list.
- Numpad + / Numpad -: browse entries and display the selected ID.
- Numpad *: apply the selected skin to CJ.
- Automatic mode runs continuously and gradually changes loaded peds.

TROUBLESHOOTING
- Confirm CLEO is installed and the CS file is in the CLEO folder.
- Confirm the IDE lines are inside the peds section and before 'end'.
- Check for duplicate IDs.
- Confirm both DFF and TXD exist and match the IDE names.
- Test one known-working model first.
- Back up game files before editing.

CREDITS
Mod: RandomSkins Global v4
Developer: MASTER SAYED
This package does not include third-party character/skin assets.
Please do not re-upload it under another developer's name or remove the developer credit.
