EzScript

The official GemStone IV encyclopedia.
Revision as of 10:59, 17 March 2026 by HOST-GSKEBECHET (talk | contribs) (Updating with templates and rearranging some information per Gswiki:Style guide/Item scripts; updating table to be compatible with screen readers)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

EzScript (sometimes referred to as a custom script) is a highly customizable fluff script that can be applied to items. EzScripted items are sometimes sold at festivals with pre-written messaging built into them. In October 2024, EzScripts were converted to flourishes. The terminology is still EzScript.

Items can have a customized EzScript applied to them via Sadie as part of the Long-term Benefits for a Premium subscription. See that article for pricing. If your item already has the EzScript on it, pricing follows the standard for items that already have the EzScript applied. If your item currently has any other script, it cannot also take the EzScript except as a flourish.

Any alteration must be in line with what the item does, but it could take a long or a show, or both, or a custom loresong, dependent on any requirements of the primary script.

Analyze

You analyze your jackal-headed ring and sense that the item is largely free from merchant alteration restrictions.

The creator has also provided the following information:

This is an EzScripted item.  Some alteration restrictions may apply.  It has the following messaging:

  wave
  1st Person: You wave your noisemaker wildly over your head, and the movement of air through the contraption creates a low-toned whistle.  A tiny flurry of white, azure, and gold confetti floats down around you.
  3rd Person: Vanah waves her noisemaker wildly over her head, and the movement of air through the contraption creates a low-toned whistle.  A tiny flurry of white, azure, and gold confetti floats down around her.

  tilt
  1st Person: Tilting your noisemaker upside down, you give it a little shake, but no confetti falls out.  Holding it up, you peer into the open end, and all of a sudden a cloud of violet and silver confetti hits you in the face!
  3rd Person: Tilting her noisemaker upside down, Vanah gives it a little shake, but no confetti falls out.  Holding it up, she peers into the open end, and all of a sudden a cloud of violet and silver confetti hits her in the face!
  Hidden:     A cloud of violet and silver confetti bursts forth and glitters down over the area.

If there is a typo in the above messaging, please ASSIST and request a referral to speak to a GameMaster to fix it.  DO NOT BUG or BUGITEM the ring!

Usage

Available verbs and their messaging varies depending on the item. Messaging is customized, so there is no standard verb messaging for all EzScripted items.

Additional Information

Verbs

You can choose the first person view, third person view, and (for some verbs) a message the room will get when you activate the item when hidden.

When planning the messaging, please keep in mind that the EzScript does not check for various statuses, so the messaging has to be fairly generic. For example, you cannot tilt your dagger and take a step forward, because the EzScript does not check to see if you are sitting first.

The full list of currently available verbs is bounce, bow, clean, close, chortle, curtsy, flip, growl, hug, kiss, lace, lean, open, pinch, poke, prance, pull, purr, push, raise, roar, rub, smell, swoon, tap, tickle, tilt, touch, toss, turn, wave, remove, wear, whistle, and yell. However, not all of these verbs may be available for your particular item or work the way you expect. Verb messaging cannot be targeted for persons or items.

If your item is not wearable, you can disregard the held and worn categories below. If your item can be worn, there are some verb traps that will only work when worn, except for wearable weapons. Wear and Remove will message appropriately if the item is wearable and can be customized with EzScript messaging. Open and close are available for containers only.

  • These verbs will check if the player is silenced: chortle, growl, purr, roar, whistle, yell
  • These verbs will only work if the player is standing: bow, bounce, curtsy, lean, prance, swoon
  • Open and close will only work on containers.
  • Lace and wear will only work while held.
  • Pinch, poke, tap, and tickle will work regardless of whether the item is held, worn, on the ground, in a backpack, etc.
  • For other traps, if the item can be worn, the verb traps will only work while worn. Except for wearable weapons, which will only work while held.
  • Not all verbs will allow hidden or invisible messaging. If the hidden messaging is important to you, please specify so the GM working with you can double check.
Verb Held Worn Hidden Silence
Check
Standing
Check
Ground
BOUNCE X X X X
BOW X X X X
CHORTLE X X X X
CLEAN X
CLOSE X X X
CURTSY X X X X
GROWL X X X X
FLIP X
HUG X X
KISS X X
LACE X
LEAN X X X X
OPEN X X X
PINCH} X X X X
POKE X X X
PRANCE X X X X
PULL X
PURR X X X X
PUSH} X
RAISE X X
REMOVE X X
ROAR X X X X
RUB X X
SMELL X X
SWOON X X X X
TAP X X X X
TICKLE X X X X
TILT X X
TOSS X
TOUCH X X
TURN X X
WAVE X
WEAR X
WHISTLE X X X X
YELL X X X X

Messaging Character Limit

Please note that each message (1st person, 3rd person, and hidden (if eligible)) has a character limit of 511 characters, including double spaces and punctuation.

Messaging Restrictions

While a final ruling will always be made through the QC process, your item's messaging should largely revolve around the item itself, and should not imply any sort of magical abilities or divine influences. Also note that no actions can imply a change in statuses - Nothing that makes you 'leap to your feet', for example.

Items can't be made to glow, pulsate, vibrate, shake, rattle, squirm, giggle, shimmer, or emanate, unless there's a really good reason for such, based in the item's actual qualities. The item does not move independently, or do things without being activated. A non-magic item could not glow. It might glitter or scintillate if it's encrusted with gems, but it won't cast any light of its own. Avoid the words, "seems to" or "appears to". A "cloak that seems to have a life of its own" is one that tromps all over the rule of not making an item appear to have properties it does not have.

Scripts cannot:

  • Cause magical-looking effects if they are not magical.
  • Make an item sentient.
  • Make you "vanish", "disappear", or move in any way.
  • Change the normal properties of an item, cannot make a sword flare if it doesn't already.
  • Transform into things, or interact with other items on your person.
  • Do things you couldn't do, either with normal mechanics or even ACT. Such as, "Khaladon rubs his crystal ball and a fireball blooms into view and strikes beside you."
  • Basically, the script add will let you lend "personality" or "flair" to an item, but it's not the same as a "scripted" item you get at a merchant as there is far less control and checking.

Here are a couple of good examples:

First person message: You rub your falchion, and it shines a bit brighter.
Third person: Khaladon rubs his falchion and it shines a bit brighter.

Hidden view, if applicable: If this field is not provided, then when hidden, only the first person message is displayed, same if you're in an invisible state.

See Also

EzScript Information
Type Fluff
Item Classification Accessory
Armor
Clothing
Container
Miscellaneous
Item(s) Applied to
Alterable Yes
Light/Deep Yes
Customizable Yes
Custom Verb messaging
Eligible to be Added Yes
Restrictions Alterations cannot contradict the EzScript messaging.
Item Verbs
BOUNCE BOW CHORTLE CLEAN
CLOSE CURTSY GROWL FLIP
HUG KISS LACE LEAN
OPEN PINCH POKE PRANCE
PULL PURR PUSH RAISE
REMOVE ROAR RUB SMELL
SWOON TAP TICKLE TILT
TOSS TOUCH TURN WAVE
WEAR WHISTLE YELL