Manual:Help Files
The help texts players read in the game with help are kept here, one page for each, named Help/<Name>. A script in the repository fetches them from the wiki into the files the game reads, so an edit here reaches the game the next time the pages are fetched. To write one, see Editing the Wiki.
Contents
How a page reaches the game
The scripts are in vme/etc/help/:
getwikihelppage.py <Name>fetches the pageHelp/<Name>and saves it as<name>.hlp(the name in lower case) in the current directory.fetchallpages.shrunsgetwikihelppage.pyfor every help page, one line per page, most of them in the background.
fetchallpages.sh calls the Python script by its bare name, so run it from vme/etc/help/, wait until the last page is saved, and move the files into vme/etc/help/strings/, where the game reads them:
cd vme/etc/help sh fetchallpages.sh mv *.hlp strings/
One page: python3 getwikihelppage.py Bash gives bash.hlp.
What the script does to a page
getwikihelppage.py asks the wiki to render the page (the parse action of the wiki's API), so the .hlp file is the page's HTML, not its wikitext. Wiki formatting works as usual: a line that starts with a space becomes a <pre> block, bold becomes bold. Then it:
- removes HTML comments, among them the report the wiki adds at the end;
- strips the markup inside the first heading, so
= Bash =becomes<h1>Bash</h1>; - turns a link to a Help/ page that doesn't exist (a red link) into
{text}; - turns every
{text}into<a cmd='#'>text</a>. In the game that is a link: clicking it runs text as a command, since the client puts the link's text in place of the#.{Help Kick}runshelp kick, and{sail east}runssail east. A{without its}is left as it is, and the script printserror: missing end curly bracket.
A link to a Help/ page that exists stays a link to the wiki (/wiki/Help/...), which leads nowhere in the game. Use {Help Name} for cross-references.
If the page doesn't exist, the script prints the wiki's error and writes nothing, so an old .hlp file stays as it was.
Help topics: help.index
The game finds a text through vme/etc/help/strings/help.index. Each line is topic=file, for example acid ball=acidball.hlp, and the lines are grouped by their first letter between :start:a and :end:a, :start:b and :end:b, and so on. Several topics may share a file: aggressive mode, peace and peaceful all show peace.hlp.
help <words> (the do_help program in vme/zone/helpzon.zon) reads the section for the first letter of what you typed, and shows the first topic there that starts with it: help acid b finds acid ball. help topics lists every topic in the index. Below the text, the game adds a link to the page on this wiki, named after the file: peace.hlp links to Help/Peace.
A topic outside its letter's :start:/:end: lines, or in another letter's section, is never found.
The game reads the index and the .hlp file from disk each time someone asks for help, so a new or changed file is shown at once, without a reboot. The directory comes from the help zone's line in vme/etc/zonelist (../etc/help, relative to vme/bin); the files are in its strings/ directory.
Adding a help page
- Write the page here,
Help/<Name>, with a capital first letter. On this wiki the part afterHelp/is case-sensitive:Help/berserkandHelp/Berserkare two pages, and the game's link to the wiki always capitalises the file name. - Add
python3 getwikihelppage.py <Name>tovme/etc/help/fetchallpages.sh. - Fetch it into
vme/etc/help/strings/. - Add its topics to
help.index, each in its letter's section. - Commit the script, the index and the
.hlpfile, and open a pull request.
The help pages
- Accuse
- Acidball
- Aciddrop
- Acidresistance
- Acidsphere
- Acidswirl
- Admin
- Advanced
- Adze
- Affect
- Age
- Aggressive
- Aidundead
- Alias
- Alignment
- Ambush
- Animatedead
- Aoh
- Appraisal
- Areas
- Armour
- Arrests
- Ask
- Assassin
- Assassinate
- Assassinskills
- Assassinspells
- Assassinweapons
- Assist
- Assrp
- Attackswitch
- Attributes
- Awaken
- Backstab
- Baculus
- Badbreath
- Ballchain
- Banish
- Bank
- Barbarian
- Bardiche
- Barkskin
- Bash
- Bastard
- Battleaxe
- Becdecorbin
- Beginners
- Beheaded
- Berserk
- Billguisarme
- Billhook
- Bless
- Blind
- Blindingflash
- Blizzard
- Boards
- Boats
- Bob
- Boneskin
- Bot
- Bounty
- Brain
- Brambles
- Bravemode
- Break
- Breath
- Brief
- Brimstone
- Broadsword
- Brownies
- Bug
- Builder
- Buildera
- Burn
- Bury
- Bushido
- Butcher
- Caccept
- Calllightning
- Calm
- Cappoint
- Casthold
- Casting
- Causelightwounds
- Causepanic
- Causeseriouswounds
- Cbalance
- Cdefect
- Cdepose
- Cdeposit
- Cequipment
- Change
- Chargestaff
- Chargewand
- Charmanimal
- Chr
- Cinfo
- Claim
- Clan
- Clancommands
- Clandonate
- Clanenter
- Clanexit
- Clanmaster
- Clanquartermaster
- Clans
- Clantreasurer
- Claymore
- Clear
- Clearskies
- Cleave
- Clenchedfist
- Climb
- Clist
- Close
- Club
- Coldresistance
- Color
- Colourbeam
- Colourspray
- Columns
- Combat
- Comm
- Command
- Commands
- Communicate
- Compact
- Condemn
- Coneofshards
- Confusion
- Conjurer
- Conjurerskills
- Conjurerspells
- Conjurerweapons
- Consider
- Constitution
- Continualdarkness
- Continuallight
- Contract
- Contrib
- Controlledteleport
- Controlundead
- Cook
- Cpromote
- Craftsmanship
- Crank
- Createfood
- Createwater
- Creationsphere
- Creators
- Credits
- Cremove
- Crossbow
- Crowbill
- Csrank
- Cstart
- Cstore
- Ctitle
- Cudgel
- Cuff
- Cunstore
- Curare
- Cureblind
- Curelight
- Cureserious
- Curse
- Curvesword
- Cutlass
- Cwithdraw
- Dagger
- Darkelf
- Darkknight
- Darkknightskills
- Darkknightspel
- Darkknightweapons
- Darkness
- Date
- Deathlygrasp
- Decapitate
- Deleteme
- Describe
- Detectalignment
- Detectcurse
- Detectinvisible
- Detectionsphere
- Detectmagic
- Detectpoison
- Detectundead
- Dexterity
- Diagnostics
- Dictionary
- Die
- Dig
- Dirk
- Disarming
- Dispelevil
- Dispelgood
- Dispelmagic
- Displacemagic
- Ditch
- Divinationsphere
- Divineresistance
- Donate
- Dowse
- Drag
- Drink
- Drop
- Drowse
- Druids
- Druidskills
- Druidspells
- Druidweapons
- Dump
- Dustdevil
- Dwarves
- Eaglecry
- Earthquake
- Eat
- Echo
- Elbow
- Electricalshock
- Electricityresistance
- Electricitysphere
- Elves
- Emotes
- Endurancepoints
- Energydrain
- Enerybolt
- Entangle
- Enter
- Equipment
- Estoc
- Evaluate
- Examine
- Exits
- Experience
- Expert
- Extinguish
- Falchion
- Familiar
- Fart
- Fashionweapon
- Fauchard
- Fauchardfork
- Fear
- Fighter
- Fighterrp
- Fighterskills
- Fighterweapons
- Fightingstaff
- Filching
- Finalrest
- Findpath
- Fireball
- Fireblast
- Firesphere
- Firestorm
- Firstaid
- Fishspine
- Flail
- Flamberge
- Flash
- Flashinggrip
- Fleeing
- Focus
- Follow
- Footlance
- Forage
- Frenzy
- Frostball
- Frostsphere
- Gaff
- Gate
- Genders
- Get
- Give
- Glaive
- Glance
- Glowingfungus
- Gnomes
- Greatsword
- Grolls
- Groups
- Groupteleport
- Guests
- Guilds
- Guisarme
- Halberd
- Halfelves
- Halflings
- Halfogres
- Halforcs
- Hammerofkai
- Handaxe
- Harm
- Haste
- Heal
- Healanimal
- Healers
- Healerskills
- Healerspells
- Healerweapons
- Heatresistance
- Hedgewall
- Hellfire
- Help
- Herbs
- Hide
- History1
- Hit
- Hits
- Hold
- Holdanimal
- Holdflight
- Holdmonster
- Holdundead
- Holygrasp
- Holyshout
- Holytouch
- Holyword
- Houses
- Humans
- Hunt
- Iceball
- Icestorm
- Icethorn
- Idea
- Identify
- Ignore
- Immortal
- Improvedidentify
- Info
- Inform
- Insult
- Inventory
- Invisibility
- Javelin
- Jeddart
- Join
- Jolt
- Khorsabadassassin
- Kick
- Kill
- Kindred
- Knee
- Knight
- Knock
- Kopesh
- Lance
- Lantern
- Lavaflow
- Laws
- Laytrap
- Leadership
- Leafshield
- Leatherskin
- Leave
- Leaving
- Letter
- Level
- Levels
- Lifeprotection
- Lightningbolt
- Lightningstorm
- List
- Listen
- Locate
- Locateanimal
- Locateobject
- Locateperson
- Lochaber
- Lock
- Login
- Loginguilds
- Loginraces
- Longbow
- Longsword
- Look
- Lucern
- Mace
- Madness
- Magiccandle
- Magicians
- Maingauche
- Manaboost
- Manapoints
- Map
- Mattock
- Maul
- Mending
- Meteorshower
- Midgaard
- Midgaardpaladins
- Midgaardsorcerer
- Militaryfork
- Mindshield
- Mindsphere
- Minorgate
- Mire
- Money
- Monster
- Morningstar
- Motd
- Mount
- Movement
- Mudpuddle
- Naginata
- Names
- Necro
- Necromancerskills
- Necromancerspells
- Necromancerweapons
- Newbie
- News
- Nightglobe
- Noshout
- Oddweapon
- Odinstatue
- Offer
- Open
- Paladins
- Paladinskills
- Paladinspells
- Paladinweapons
- Palrp
- Partisan
- Password
- Pastgods
- Pe
- Peace
- Peeking
- Personality
- Petrify
- Pibag
- Picklock
- Pickpockets
- Pike
- Pilum
- Piset
- Plague
- Plant
- Poisonivy
- Poisonresistance
- Poisonsphere
- Polarity
- Polearms
- Poleaxe
- Polecleaver
- Policeguild
- Portal
- Position
- Potions
- Pour
- Poweritems
- Practice
- Pray
- Privacy
- Professions
- Promptcolors
- Protected
- Protectionfromevil
- Protectionfromgood
- Protectionsphere
- Purse
- Put
- Quarterstaff
- Quests
- Quicken
- Quicksand
- Quit
- Races
- Rage
- Raisedead
- Raisedivine
- Raisehitpoints
- Raisehorde
- Raisemagic
- Raiseskeletalchampion
- Raiseskeleton
- Randomteleport
- Ranger
- Rangerskills
- Rangerspells
- Rangerweapons
- Ranseur
- Rapier
- Read
- Reconstruct
- Refit
- Refresh
- Regenerate
- Remove
- Removecurse
- Removedisease
- Removepoison
- Rend
- Repair
- Repelgreaterundead
- Repellesserundead
- Reply
- Rescue
- Resize
- Respond
- Ressurect
- Rules
- Sail
- Sanctuary
- Sappara
- Save
- Say
- Scan
- Scimitar
- Score
- Scrolluse
- Search
- Sending
- Senselife
- Shamshir
- Shelter
- Shields
- Shoot
- Shops
- Shortsword
- Shout
- Sickle
- Sip
- Skills
- Skin
- Slam
- Slip
- Slow
- Slowrot
- Sneaking
- Snoop
- Snowball
- Socials
- Solarflare
- Soothe
- Sorcerer
- Sorcererskills
- Sorcererspells
- Sorcererweapons
- Soulfire
- Soulshift
- Spear
- Spearfam
- Spellaid
- Spelllight
- Spelllock
- Spellsleep
- Spellstrength
- Spellunlock
- Spetum
- Spheres
- Spies
- Splitm
- Sprayofacid
- Staff
- Stalk
- Status
- Stealing
- Stiletto
- Stinkingbreath
- Stinkingcloud
- Stoneskin
- Storage
- Stormcall
- Stormgate
- Str
- Stun
- Summerrain
- Summonair
- Summonanimal
- Summondemon
- Summondevil
- Summonearth
- Summonfire
- Summoningresistance
- Summoningsphere
- Summonlightning
- Summonwater
- Sunbeam
- Sunglobe
- Sunray
- Sustain
- Swimming
- Talwar
- Taste
- Tell
- Terminal
- Thief
- Thiefrp
- Thiefskills
- Thiefspells
- Thiefweapons
- Thornstrike
- Throw
- Tigerclaw
- Time
- Title
- Totalrecall
- Toxicate
- Track
- Transport
- Travel
- Trident
- Trigger
- Tripping
- Tsunami
- Tuborg
- Turnundead
- TwoWeaponStyle
- Typo
- Udgaard
- Undeaddoor
- Unholygrasp
- Unholyshout
- Unholytouch
- Unholyword
- Unseen
- Use
- Valhalla
- Variable
- Ventriloquate
- Voulge
- Wanted
- Waraxe
- Warhammer
- Weap
- Weapons
- Wear
- Weather
- When
- Whip
- Whirl
- Whisper
- Who
- Wield
- Wimpy
- Windslash
- Wizardeye
- Wizardmark
- Wizlist
- Wordofrecall
- Write
- Xrayvision
- Yule
- berserk
- charge
- defend
- leap
- taunt