Commands

There are several commands that can be used to control your gems, with two only being useable by Nephrites. The following commands are:

**/scoutlocate [structure]** - Use with a Nephrite and an empty map in her inventory to find a specified structure! She should be able to locate vanilla Minecraft structures along with Gempire generated structures.

**/scoutlocatebiome [biome]** - Use with a Nephrite and an empty map in her inventory to find a specified biome! She should be able to locate vanilla Minecraft biomes along with Gempire generated biomes.

**/masswander** - Tell every gem in the vicinity to wander. An excellent way to quickly tell your entourage to disperse.

**/massfollow** - Tell every gem in the vicinity to follow. Ready to go on an expedition? Quickly gather your soldiers and head out!

**/massstay** - Tell every gem in the vicinity to stay. Tired of all your gems wandering around aimlessly or following your every move? Tell them to stay put!

**/masspoof** - Poof every gem in your vicinity. Useful for clearing out an abundance of gems. **ONLY** works if the gems are tamed to you.

## Using /summon to make something new

Just like Gempire's predecessor, KAGIC, you can use the vanilla /summon command from Minecraft to create your own customized gems. While this guide is a WIP, here are the things you can do that are confirmed to work.

* hairVariant: (dependent on how many hair variants the gem entity has, like how Quartz and Pearl have multiple hairs while Topaz only has one)
* CustomName: (this is a rather complex tag to use and is hard to explain, more notes below)
* skinColorVariant: (specifies what gem to drop if the entity you're altering has multiple gem variants, like Quartz, Jasper, Pearl, etc)
* abilities: (check the Gempire Github for ability numbers, you use it like abilities:"8,2,1," as an example. NOTE THAT SOME ABILITIES CAN CRASH THE GAME IF USED, SOME OTHERS ARE NOT IMPLEMENTED YET AND ARE USELESS)
* markingVariant: (dependent on if the gem entity has marking layers for markings)
* markingColor:
* marking2Variant: (dependent on if the gem entity has two sets of markings)
* outfitVariant: (dependent on how many outfits the gem entity has registered)
* insigniaColor: (dye colors 0 through 15)
* outfitColor: (dye colors 0 through 15)
* insigniaVariant: (dependent on how many insignias the gem entity has registered)
* gemPlacement: (valid placements 0 through 31, you can view more information here. keep in mind that different gem entities have different valid placements and not every gem has the same amount variants used)

When using **skinColor, gemColor, hairColor and markingColor**, you must use a hexidecimal to decimal code converter. I like to use this one.

Here are some example commands.

/summon gempire:quartz ~ ~ ~ {CustomName:'{"text":"Ametrine","color":"yellow"}',skinColorVariant:10,skinColor:12296670,hairColor:16312062,outfitVariant:0,gemColor:16770406,abilities:"1,20,3",hairVariant:11,gemPlacement:11,outfitColor:11,insigniaColor:3}

/summon gempire:quartz ~ ~ ~ {CustomName:'{"text":"Orange River Quartz"}',skinColor:15235359,gemColor:15635715,hairColor:9641485,hairVariant:5,skinColorVariant:14,insigniaVariant:0,outfitVariant:0,insigniaColor:10,outfitColor:1,gemPlacement:11}

## How to use CustomName on your /summon gems

Here's an example command using CustomName. This command summons a Jasper with a name of Golden Apple Aura Quartz, that has a colored nametag. Note that her skin, gem, and hair textures are black because there's no specified colors for those layers.

/summon gempire:jasper ~ ~ ~ {CustomName:'{"text":"Golden Apple Aura Quartz","color":"gold"}'}

Here is a chart of all the valid colors for the custom names.