Skip to content

OLC Other Editors

Kit Oliynyk edited this page Nov 3, 2026 · 2 revisions

TL;DR: Besides rooms, mobs and objects, OLC has editors for help articles, skills, skill groups, commands, socials, races, religions, behaviors, config files and area quests. They edit game data kept in dreamland_world and save it straight to the world files when you leave with done. Use when: you change a help article, a skill, a command, a social, a race, a religion, a behavior or a config file in game, or you need to know what olcdump and abc do. Source of truth: every CMD( line under plug-ins/olc gives the entry command, and the HEDIT, SKEDIT, GREDIT, CMDEDIT, SOCEDIT, RACEEDIT, RELEDIT, BEDIT, FEDIT and AQEDIT macros in the same files give each editor's commands. Verified: 2026-11-02 against dreamland_code a7c4fd10, dreamland_world a35c62ce

What they have in common

  • They open with their entry command and a name or id: hedit 1052, skedit fireball. The name is matched by prefix, an ambiguous name lists the candidates.
  • Commands are listed by commands. Text fields have the usual web, copy, paste subcommands and uaname/runame style variants: OLC.
  • They change the live definition at once. done writes the definition file to disk if anything changed and prints "Изменения сохранены на диск" (changes saved to disk). Without done the change is live in memory only and is lost at the next boot. hedit and fedit keep a copy and apply it at done.
  • Most of them create the missing pieces for you: create makes a new definition file and a help id, help inside an editor opens or creates the help article of the thing.
  • Edits go to the world files of dreamland_world. A change you want to keep must be committed there. See Data-Configs.

Never delete or move the help article of a skill, command or spell. The engine takes the id of the skill's spell, affect handler and command from that help id, and a skill with a spell, affect or command and no help makes the server stop at boot. To hide a help article, set its level (level 102) instead.

hedit: help articles

hedit <keywords>
hedit <id>
hedit list
hedit create
hedit search <text>
hedit label [<name>|none]
hedit save
Form Result
hedit <keywords> Opens the article with those keywords. Several matches print a list with ids.
hedit <id> Opens an article by its id.
hedit list Every article with id, title and keywords.
hedit create A new empty article with the next free id.
hedit search <text> Articles whose text contains it, including link anchors such as hh123.
hedit label The categories and labels with the number of articles. label <name> lists the articles of one, label none those with no category.
hedit save Saves every article.

Commands inside: keywords, aka (hidden aliases), title, labels, seealso, alias, level (the level from which the article is shown), text, each with ua and ru variants where they hold text. done saves the article.

Before you pick an id for a new article, ask the server for the next free one with abc maxhelp. Writing help text is covered in Help-Articles.

skedit and gredit: skills and groups

skedit <skill>
skedit create class|clan|race|other <english name>
skedit list [all|active|passive|magic|prayer|invalid|<group>]
skedit save
gredit <group>
gredit save

skedit create makes a new skill definition, in lowercase English letters and spaces. A skill that existed only as a placeholder is replaced.

skedit list prints name, type, mana, moves, wait, tier and a star when a Fenia script overrides the skill.

Commands in skedit: affect, action and spell create the affect handler, command and spell of the skill. fenia <method> opens the script editor for the spell or affect. help creates or shows the skill help. show. Costs: mana, move, pmana, pmove, phealth (percent), beats (wait state in pulses, a quarter second each). Identity: uaname, runame, ukrname, rusname, aliases, ukraliases, rusaliases, hint. Rules: group, allow (class, clan, race limits), align, ethos, mob, position, order, target, argtype, type, ranged, flags, tier. Damage: damtype, damflags, dammsg, damgender. Affect: negative, autobuff, cancelled, dispelled, grants, removeCharSelf, removeCharOthers, removeRoom, removeObj, messages.

  • negative marks the skill's affect as a debuff. The affects command shows it in red. Permanent buffs show in cyan and timed buffs in yellow.
  • grants lists the permanent affects that a passive skill keeps on.
  • The tier is a damage level from 1 to 5.

Commands in gredit: show, help, uaname, runame, self, victim, room (the cast messages of the group), practicer (vnum of the teacher mob), hidden, gods (patron gods), path.

Spell prices on items are not set here: see Item-Power.

cmdedit and socedit: commands and socials

cmdedit <command>
cmdedit list
cmdedit ua
cmdedit create <name>
socedit <social>

cmdedit list shows every command. A command that belongs to a skill opens skedit instead. cmdedit ua prints the English, Russian and Ukrainian names and aliases side by side. create makes a new command with a help article.

Commands in cmdedit: fenia, help, hint, ukrname, rusname, aliases, ukraliases, rusaliases, level, flags, category, order, position, show.

socedit edits one social. language en|ua|ru chooses which language the message commands write. The messages are charNoArgument, othersNoArgument, charFound1, othersFound1, victimFound1, charNotFound, othersAuto, charFound2, othersFound2, victimFound2, victimObj, charVictimObj, othersVictimObj, charObj, othersObj. Others: show, russian, shortdesc, position, aliases.

raceedit: races

raceedit <race>
raceedit list [name|rname|count]
raceedit create pc|npc <english name>

list shows every race with its name, Russian name and the number of mob prototypes that use it. create makes a player race or a mob-only race.

Commands include the names in all genders (male, female, neuter, mult), how the race shows in score and who (score, whoeng, whorus, whofemale), the old flag sets (act, oaff, det, off, imm, res, vuln, form, parts), the body model (forms, partsadd, partsdel, actdel, offdel, affdel, detdel, immdel, resdel, vulndel), mob defaults (damtype, material, hpmult, dmgmult, moveverb, spec, size, wearloc), player options (affects, hunts, donates, stats, align, minalign, maxalign, hp, mana, prac). A race with a forms list uses the body model, see Mob-Forms-and-Parts. After an edit the race recomputes its resolved body the next time it is used. Prototypes of existing mobs are rebuilt at their next done or at boot.

reledit: religions

reledit <religion>
reledit list
reledit mark
reledit create <english keyword>

list prints name, sex, alignment, ethos and whether the religion is limited by race, class or clan. The command mark lists religions with the vnum of their sign (tattoo) item.

Commands: show, short, russian, sex, desc, flags, mark, align, ethos, races, classes, clans, minstat, maxstat, age, praces, pclasses, pclans, paths. The first group describes the god, the races, classes, clans, minstat, maxstat, age fields limit who may join, and the p... fields name races, classes and clans that the god favours.

bedit: behaviors

bedit <behavior>
bedit list
bedit create <name>

A behavior is a named bundle of Fenia triggers and properties that can be attached to many mobs, objects or rooms. bedit list shows the name, the target (mob, object or room) and how many prototypes use it. Commands: fenia (triggers), affect, nameRus, nameUa, description, target, props (default properties as JSON), subcommands (for item use), help, list (entities that use it), show. How behaviors are attached and dispatched: Fenia-Behaviors.

fedit: config files

fedit list [<text>]
fedit <path>

Opens a JSON configuration file of the world in the web editor (web client only). done checks that the JSON parses and saves the file, and refuses to leave if it does not. A file too large for the browser editor is refused: edit it on disk and reload with plug reload most. The list groups the files by folder. What each file does is in Data-Configs.

qedit: area quests

qedit <number>
qedit list

Quests are created from aedit with quest create. qedit edits one and lists them all, with a star for quests that have entry conditions. Full description: Area-Quests.

olcdump

olcdump
olcdump <object or mob in the room>

Prints the stored XML of the room you stand in, or of the prototype of an object or mob that is here. Use it to see what will be written to the area file.

abc

abc is a diagnostic command for level 106. Subcommands:

Subcommand Who Result
abc ed level 106 Room extra descriptions whose keywords appear nowhere in the room description.
abc eexit level 106 Every extra exit with its two names, grouped into clans, mansions and the rest.
abc maxhelp coder The highest help id in use and the next free one.
abc body coder Review of the mob body diffs: prototypes with authored differences, unreviewed removals (abc body dels), live mobs that differ from their prototype (abc body instances).
abc badresets coder Mob equipment resets that put an item into a slot the mob's race does not have.
abc readroom <vnum> coder Reloads the saved objects of a room.
abc obj_update, char_update, weather_init coder Forces that update now.

See also: OLC, Help-Articles, Fenia-Behaviors, Mob-Forms-and-Parts, Data-Configs.

Clone this wiki locally