How to add a Personal Item into the Umbra Server
Personal Items 101:
Introduction:
The Umbra Sector offers characters the opportunity to bring special and personalised items and clothing to the station. These items can have personal sprites, icons or just be a renamed item with slightly different properties. There are a few limits to these items that this page will go over but any questions can be forwarded to Maintainers if necessary!
Limitations of Personal Items:
There are a set of guidelines regarding what personal items can be on the Umbra Sector. If you have any specific questions regarding the functionality or look to a personal item, you can ask in #questions-to-gms or @maintainers for any functionality questions.
How to add Personal Items:
There are three locations for files that you will be working with for adding personal items. They are:
- Resources/Textures/_Umbra/PersonalItems/[...]/name.rsi
- Resources/Prototypes/_Umbra/PersonalItems/[...]/name.yml
- Resources/Prototypes/_Umbra/Loadouts/loadout_groups.yml
It is recommended you peruse though other made personal items but there are a set of coding guidelines for Personal Items. Personal Items should be a max of three words. One word for the characters name, and a max of two words regarding the item itself. This will be used to create the ID of the item, as well as the name for the file. Personal Item IDs all start with "PersonalItem". All names for items should only be capitalised if there is a name for a character owning an item, not if the item is of the character. For example:
- John's winter coat
- The name "John" is capitalised as they own the winter coat
- The name "winter coat" is lowercase as it is the name of the item
- This would become johnwintercoat.rsi and johnwintercoat.yml
- The Personal Item ID would be PersonalItemJohnWinterCoat
- The name "John" is capitalised as they own the winter coat
- john plushie
- The name "john" is lowercase as it isn't the owner rather an item about the owner
- the name "plushie" is lowercase as it is the name of the item
- This would become johnplushie.rsi and johnplushie.yml
- The Personal Item ID would be PersonalItemJohnPlushie
To add the item to the Personal Item section in game, you must add two sections. One within name.yml and loadout_groups.yml.