From d265de74d4c28460961f8e646b1b574997756ea2 Mon Sep 17 00:00:00 2001 From: lethosor Date: Fri, 3 Jul 2020 16:16:07 -0400 Subject: [PATCH] Clean up some script docs (base + modtools) --- adaptation.rb | 8 +++++-- add-thought.lua | 2 +- adv-fix-sleepers.lua | 12 +++++----- assign-attributes.lua | 20 ++++++++--------- assign-beliefs.lua | 29 ++++++++++++------------ assign-facets.lua | 24 ++++++++++---------- assign-goals.lua | 11 ++++----- assign-preferences.lua | 46 +++++++++++++++++++++++--------------- assign-profile.lua | 34 +++++++++++++++------------- assign-skills.lua | 10 +++++---- color-schemes.lua | 4 ++-- deep-embark.lua | 3 ++- deteriorateclothes.rb | 6 +++-- deterioratecorpses.rb | 6 +++-- deterioratefood.rb | 6 +++-- dorf_tables.lua | 8 +++---- emigration.lua | 8 ++++--- load-save.lua | 12 +++++----- markdown.lua | 8 ++++--- migrants-now.lua | 6 +++-- modtools/extra-gamelog.lua | 5 +++++ modtools/if-entity.lua | 4 ++-- modtools/set-need.lua | 3 ++- names.lua | 8 +++---- putontable.lua | 4 +++- setfps.lua | 8 +++++-- teleport.lua | 23 ++++++++++++++----- tidlers.lua | 3 ++- troubleshoot-item.lua | 3 ++- unforbid.rb | 7 ++++-- view-item-info.lua | 2 +- 31 files changed, 197 insertions(+), 136 deletions(-) diff --git a/adaptation.rb b/adaptation.rb index 23bb7ab88c..b7c6c3c4e1 100644 --- a/adaptation.rb +++ b/adaptation.rb @@ -5,8 +5,12 @@ adaptation ========== View or set level of cavern adaptation for the selected unit or the whole fort. -Usage: ``adaptation [value]``. The ``value`` must be -between 0 and 800,000 inclusive. + +Usage:: + + adaptation [value] + +The ``value`` must be between 0 and 800,000 (inclusive). =end diff --git a/add-thought.lua b/add-thought.lua index ba4e19a500..5463ff5b14 100644 --- a/add-thought.lua +++ b/add-thought.lua @@ -6,7 +6,7 @@ add-thought =========== Adds a thought or emotion to the selected unit. Can be used by other scripts, -or the gui invoked by running ``add-thought gui`` with a unit selected. +or the gui invoked by running ``add-thought -gui`` with a unit selected. ]====] diff --git a/adv-fix-sleepers.lua b/adv-fix-sleepers.lua index 40ab6a74d4..e92a01e0e7 100644 --- a/adv-fix-sleepers.lua +++ b/adv-fix-sleepers.lua @@ -4,12 +4,14 @@ adv-fix-sleepers ================ Fixes :bug:`6798`. This bug is characterized by sleeping units who refuse to - awaken in adventure mode regardless of talking to them, hitting them, or - waiting so long you die of thirst. +awaken in adventure mode regardless of talking to them, hitting them, or waiting +so long you die of thirst. If you come accross one or more bugged sleepers in +adventure mode, simply run the script and all nearby sleepers will be cured. + +Usage:: + + adv-fix-sleepers -Usage: If you come accross one or more bugged sleepers in adventure mode, - simply run the script (type adv-fix-sleepers into the dfhack console), - and all nearby sleepers will be cured. ]====] diff --git a/assign-attributes.lua b/assign-attributes.lua index cb48855a89..b87b21a0ae 100644 --- a/assign-attributes.lua +++ b/assign-attributes.lua @@ -53,19 +53,19 @@ Usage: are present, the unit attributes will be reset and then the listed attributes will be modified. -Example: +Example:: -``assign-attributes -reset -attributes [ STRENGTH 2 AGILITY -1 SPATIAL_SENSE -1 ]`` - This will reset all attributes to a neutral value and will set - the following values (if the currently selected unit is a dwarf): + assign-attributes -reset -attributes [ STRENGTH 2 AGILITY -1 SPATIAL_SENSE -1 ] - * Strength: a random value between 1750 and 1999 (tier 2); - * Agility: a random value between 401 and 650 (tier -1); - * Spatial sense: a random value between 1043 and 1292 (tier -1). +This will reset all attributes to a neutral value and will set the following +values (if the currently selected unit is a dwarf): - The final result will be: - ``She is very strong, but she is clumsy. - She has a questionable spatial sense.`` + * Strength: a random value between 1750 and 1999 (tier 2); + * Agility: a random value between 401 and 650 (tier -1); + * Spatial sense: a random value between 1043 and 1292 (tier -1). + +The final result will be: "She is very strong, but she is clumsy. +She has a questionable spatial sense." ]====] local utils = require("utils") diff --git a/assign-beliefs.lua b/assign-beliefs.lua index 5d78667d6c..9338d66785 100644 --- a/assign-beliefs.lua +++ b/assign-beliefs.lua @@ -48,24 +48,25 @@ Usage: first all the unit beliefs will be reset and then those beliefs listed after ``-beliefs`` will be modified. -Example: +Example:: -``assign-beliefs -reset -beliefs [ TRADITION 2 CRAFTSMANSHIP 3 POWER 0 CUNNING -1 ]`` - Resets all the unit beliefs, then sets the listed - beliefs to the following values: + assign-beliefs -reset -beliefs [ TRADITION 2 CRAFTSMANSHIP 3 POWER 0 CUNNING -1 ] - * Tradition: a random value between 26 and 40 (level 2); - * Craftsmanship: a random value between 41 and 50 (level 3); - * Power: a random value between -10 and 10 (level 0); - * Cunning: a random value between -25 and -11 (level -1). +Resets all the unit beliefs, then sets the listed beliefs to the following +values: - The final result (for a dwarf) will be: - ``She personally is a firm believer in - the value of tradition and sees guile and - cunning as indirect and somewhat worthless.`` +* Tradition: a random value between 26 and 40 (level 2); +* Craftsmanship: a random value between 41 and 50 (level 3); +* Power: a random value between -10 and 10 (level 0); +* Cunning: a random value between -25 and -11 (level -1). + +The final result (for a dwarf) will be: "She personally is a firm believer in +the value of tradition and sees guile and cunning as indirect and somewhat +worthless." + +Note that the beliefs aligned with the cultural values of the unit have not +triggered a report. -Note that the beliefs aligned with the cultural -values of the unit have not triggered a report. ]====] local utils = require("utils") diff --git a/assign-facets.lua b/assign-facets.lua index 3ad7806e15..0325ff2daf 100644 --- a/assign-facets.lua +++ b/assign-facets.lua @@ -48,22 +48,22 @@ Usage: first all the unit facets will be reset and then those facets listed after ``-facets`` will be modified. -Example: +Example:: -``assign-facets -reset -facets [ HATE_PROPENSITY -2 CHEER_PROPENSITY -1 ]`` - Resets all the unit facets, then sets the listed facets to the following values: + assign-facets -reset -facets [ HATE_PROPENSITY -2 CHEER_PROPENSITY -1 ] - * Hate propensity: a value between 10 and 24 (level -2); - * Cheer propensity: a value between 25 and 39 (level -1). +Resets all the unit facets, then sets the listed facets to the following values: - The final result (for a dwarf) will be: - ``She very rarely develops negative feelings - toward things. She is rarely happy or enthusiastic, - and she is conflicted by this as she values - parties and merrymaking in the abstract.`` +* Hate propensity: a value between 10 and 24 (level -2); +* Cheer propensity: a value between 25 and 39 (level -1). + +The final result (for a dwarf) will be: "She very rarely develops negative +feelings toward things. She is rarely happy or enthusiastic, and she is +conflicted by this as she values parties and merrymaking in the abstract." + +Note that the facets are compared to the beliefs, and if conflicts arise they +will be reported. - Note that the facets are compared to the beliefs, - and if conflicts arise they will be reported. ]====] local utils = require("utils") diff --git a/assign-goals.lua b/assign-goals.lua index 07977b631a..a12ab8dbca 100644 --- a/assign-goals.lua +++ b/assign-goals.lua @@ -41,12 +41,13 @@ Usage: the unit goals will be erased and then those goals listed after ``-goals`` will be added. -Example: +Example:: + + assign-goals -reset -goals [ MASTER_A_SKILL false ] + +Clears all the unit goals, then sets the "master a skill" goal. The final result +will be: "dreams of mastering a skill". -``assign-goals -reset -goals [ MASTER_A_SKILL false ]`` - Clears all the unit goals, then sets the "master - a skill" goal. The final result will be: - ``dreams of mastering a skill.`` ]====] local utils = require("utils") diff --git a/assign-preferences.lua b/assign-preferences.lua index 1b57955c87..f41812bc3f 100644 --- a/assign-preferences.lua +++ b/assign-preferences.lua @@ -152,32 +152,42 @@ Usage: Examples: -``assign-preferences -reset -likematerial [ INORGANIC:OBSIDAN PLANT:WILLOW:WOOD ]`` - "likes alabaster and willow wood" +* "likes alabaster and willow wood":: -``assign-preferences -reset -likecreature SPARROW`` - "likes sparrows for their ..." + assign-preferences -reset -likematerial [ INORGANIC:OBSIDAN PLANT:WILLOW:WOOD ] -``assign-preferences -reset -likefood [ PLANT:MUSHROOM_HELMET_PLUMP:DRINK PLANT:OLIVE:FRUIT ]`` - "prefers to consume dwarven wine and olives" +* "likes sparrows for their ...":: -``assign-preferences -reset -hatecreature SPIDER_JUMPING`` - "absolutely detests jumping spiders + assign-preferences -reset -likecreature SPARROW -``assign-preferences -reset -likeitem [ WOOD ITEM_WEAPON:ITEM_WEAPON_AXE_BATTLE ]`` - "likes logs and battle axes" +* "prefers to consume dwarven wine and olives":: -``assign-preferences -reset -likeplant BERRIES_STRAW`` - "likes straberry plants for their ..." + assign-preferences -reset -likefood [ PLANT:MUSHROOM_HELMET_PLUMP:DRINK PLANT:OLIVE:FRUIT ] -``assign-preferences -reset -liketree OAK`` - "likes oaks for their ..." +* "absolutely detests jumping spiders:: -``assign-preferences -reset -likecolor AQUA`` - "likes the color aqua" + assign-preferences -reset -hatecreature SPIDER_JUMPING + +* "likes logs and battle axes":: + + assign-preferences -reset -likeitem [ WOOD ITEM_WEAPON:ITEM_WEAPON_AXE_BATTLE ] + +* "likes straberry plants for their ...":: + + assign-preferences -reset -likeplant BERRIES_STRAW + +* "likes oaks for their ...":: + + assign-preferences -reset -liketree OAK + +* "likes the color aqua":: + + assign-preferences -reset -likecolor AQUA + +* "likes stars":: + + assign-preferences -reset -likeshape STAR -``assign-preferences -reset -likeshape STAR`` - "likes stars" ]====] local utils = require("utils") diff --git a/assign-profile.lua b/assign-profile.lua index 3c9f07d3fb..eb45113f0d 100644 --- a/assign-profile.lua +++ b/assign-profile.lua @@ -50,22 +50,24 @@ Usage: Examples: -``assign-profile -reset ALL`` - Resets/clears all the characteristics of the - unit, leaving behind a very bland character. - -``assign-profile -profile CARPENTER -reset PROFILE`` - Loads and applies the profile called "CARPENTER" - in the default json file, resetting/clearing - all the characteristics listed in the - profile, and then applying the new values. - -``assign-profile -file /hack/scripts/military_profiles.json -profile ARCHER -reset ATTRIBUTES`` - Loads and applies the profile called "ARCHER" - in the provided json file, keeping all the old - characteristics but the attributes, which will - be reset (and then, if the profile provides some - attributes values, those value will be applied). +* Resets/clears all the characteristics of the unit, leaving behind a very bland + character:: + + assign-profile -reset ALL + +* Loads and applies the profile called "CARPENTER" in the default json file, + resetting/clearing all the characteristics listed in the profile, and then + applying the new values:: + + assign-profile -profile CARPENTER -reset PROFILE + +* Loads and applies the profile called "ARCHER" in the provided json file, + keeping all the old characteristics but the attributes, which will be reset + (and then, if the profile provides some attributes values, those value will be + applied):: + + assign-profile -file /hack/scripts/military_profiles.json -profile ARCHER -reset ATTRIBUTES + ]====] local json = require "json" diff --git a/assign-skills.lua b/assign-skills.lua index 3bf8164bd8..bc56a320c8 100644 --- a/assign-skills.lua +++ b/assign-skills.lua @@ -59,11 +59,13 @@ Usage: first all the unit skills will be cleared and then the listed skills will be added. -Example: +Example:: + + assign-skills -reset -skills [ WOODCUTTING 3 AXE 2 ] + +Clears all the unit skills, then adds the Wood cutter skill (competent level) +and the Axeman skill (adequate level). -``assign-skills -reset -skills [ WOODCUTTING 3 AXE 2 ]`` - Clears all the unit skills, then adds the Wood cutter skill - (competent level) and the Axeman skill (adequate level). ]====] local utils = require("utils") diff --git a/color-schemes.lua b/color-schemes.lua index 62fd061cee..02bd806448 100644 --- a/color-schemes.lua +++ b/color-schemes.lua @@ -22,8 +22,8 @@ Loaded as a module, this script will export those methods : For more information about arguments and return values, see ``hack/scripts/color-schemes.lua``. -Notes : - * `gui/color-schemes` is the in-game GUI for that script. +Related scripts: + * `gui/color-schemes` is the in-game GUI for this script. * `season-palette` swaps color schemes when the season changes. ]====] diff --git a/deep-embark.lua b/deep-embark.lua index eb655ec371..c7d709513e 100644 --- a/deep-embark.lua +++ b/deep-embark.lua @@ -20,7 +20,8 @@ cause the script to run automatically and should hence be especially useful for modders who want their mod to include underground embarks by default. -example: +Example:: + deep-embark -depth CAVERN_2 Usage:: diff --git a/deteriorateclothes.rb b/deteriorateclothes.rb index 33084185e7..fca9a3437a 100644 --- a/deteriorateclothes.rb +++ b/deteriorateclothes.rb @@ -9,7 +9,9 @@ and eventually just crumble into nothing. As warm and fuzzy as a dining room full of used socks makes your dwarves feel, your FPS does not like it. -Usage: ``deteriorateclothes (start|stop)`` +Usage:: + + deteriorateclothes start|stop =end @@ -78,4 +80,4 @@ def status else puts 'Not loaded.' end -end \ No newline at end of file +end diff --git a/deterioratecorpses.rb b/deterioratecorpses.rb index 56003f6d0e..1edc1b4dc9 100644 --- a/deterioratecorpses.rb +++ b/deterioratecorpses.rb @@ -22,7 +22,9 @@ This script causes all of those to rot away into nothing after several months. -Usage: ``deterioratecorpses (start|stop)`` +Usage:: + + deterioratecorpses start|stop =end @@ -103,4 +105,4 @@ def status else puts 'Not loaded.' end -end \ No newline at end of file +end diff --git a/deterioratefood.rb b/deterioratefood.rb index c59171ea56..598c0c07bd 100644 --- a/deterioratefood.rb +++ b/deterioratefood.rb @@ -20,7 +20,9 @@ helmets, just as many fish and meat. It gets pretty absurd. And your FPS doesn't like it. -Usage: ``deterioratefood (start|stop)`` +Usage:: + + deterioratefood start|stop =end @@ -93,4 +95,4 @@ def status else puts 'Not loaded.' end -end \ No newline at end of file +end diff --git a/dorf_tables.lua b/dorf_tables.lua index 9391ccd27d..27ceb8414e 100644 --- a/dorf_tables.lua +++ b/dorf_tables.lua @@ -1,5 +1,5 @@ -- dorf_tables has job distribution configurations, random number information for attributes generation, job configurations, profession configurations, dwarf types(ie. attributes/characteristic) configurations --- usage: loaded by pimp-it.lua +-- usage: loaded by dwarf-op.lua -- by josh cooper(cppcooper) [created: 12-2017 | last edited: 12-2018] --@ module = true @@ -7,15 +7,13 @@ local help = [====[ dorf_tables =========== -Data tables for pimp-it.lua. - -Usage: load inside secondary script (pimp-it.lua) +Data tables for `dwarf-op` - not intended to be called directly ]====] if not moduleMode then print("scripts/dorf_tables.lua is a content library; calling it does nothing.") - do return end + return end print("Loading data tables..") diff --git a/emigration.lua b/emigration.lua index e6892c6774..5cc95d5c8c 100644 --- a/emigration.lua +++ b/emigration.lua @@ -13,7 +13,9 @@ The check is made monthly. A happy dwarf (ie with negative stress) will never emigrate. -Usage: ``emigration enable|disable`` +Usage:: + + emigration enable|disable ]====] @@ -61,11 +63,11 @@ function canLeave(unit) if not unit.status.current_soul then return false end - + for _, skill in pairs(unit.status.current_soul.skills) do if skill.rating > 14 then return false end end - + return dfhack.units.isOwnRace(unit) and -- Doubtful check. naturalized citizens dfhack.units.isOwnCiv(unit) and -- might also want to leave. dfhack.units.isActive(unit) and diff --git a/load-save.lua b/load-save.lua index 7ee3057bc8..518b087029 100644 --- a/load-save.lua +++ b/load-save.lua @@ -5,15 +5,17 @@ load-save ========= When run on the title screen or "load game" screen, loads the save with the -given folder name without requiring interaction. +given folder name without requiring interaction. Note that inactive saves (i.e. +saves under the "start game" menu) are currently not supported. -Example: ``load-save region`` +Example:: -This can also be run when starting DFHack from the command line:: + load-save region1 - ./dfhack +load-save region1 +This can also be run when starting DFHack from the command line. For example, +on Linux/macOS:: -(This is currently untested on Windows) + ./dfhack +load-save region1 ]====] diff --git a/markdown.lua b/markdown.lua index 56306cfa1b..5ca9f03749 100644 --- a/markdown.lua +++ b/markdown.lua @@ -5,8 +5,8 @@ local helpstr = [====[ markdown ======== -Save a copy of a text screen in markdown (for reddit among others). -See `forum-dwarves` for BBCode export (for eg. the Bay12 Forums). +Save a copy of a text screen in markdown (useful for Reddit, among other sites). +See `forum-dwarves` for BBCode export (for e.g. the Bay12 Forums). This script will attempt to read the current df-screen, and if it is a text-viewscreen (such as the dwarf 'thoughts' screen or an item / creature @@ -19,7 +19,9 @@ document containing the text from multiple screens (eg: text screens from several dwarves, or text screens from multiple artifacts/items, or some combination). -Usage: ``markdown [-n] [filename]`` +Usage:: + + markdown [-n] [filename] :-n: overwrites contents of output file :filename: diff --git a/migrants-now.lua b/migrants-now.lua index c772d4beee..6d8ae02fa7 100644 --- a/migrants-now.lua +++ b/migrants-now.lua @@ -3,8 +3,10 @@ migrants-now ============ -Forces an immediate migrant wave. Only works after migrants have -arrived naturally. Equivalent to `modtools/force` ``-eventType migrants`` +Forces an immediate migrant wave. Only works after migrants have +arrived naturally. Roughly equivalent to `modtools/force` with:: + + modtools/force -eventType migrants ]====] df.global.timed_events:insert('#',{ diff --git a/modtools/extra-gamelog.lua b/modtools/extra-gamelog.lua index ec90e80424..0b7f33c3fe 100644 --- a/modtools/extra-gamelog.lua +++ b/modtools/extra-gamelog.lua @@ -6,6 +6,11 @@ modtools/extra-gamelog This script writes extra information to the gamelog. This is useful for tools like :forums:`Soundsense <106497>`. +Usage:: + + modtools/extra-gamelog enable + modtools/extra-gamelog disable + ]====] local msg = dfhack.gui.writeToGamelog diff --git a/modtools/if-entity.lua b/modtools/if-entity.lua index 28f6feacca..a922fc6577 100644 --- a/modtools/if-entity.lua +++ b/modtools/if-entity.lua @@ -27,8 +27,8 @@ All arguments are required. Example: - # Print a message if you load an elf fort, but not a dwarf, human, etc - # fort. +- Print a message if you load an elf fort, but not a dwarf, human, etc. fort:: + if-entity -id "FOREST" -cmd [ lua "print('Dirty hippies.')" ] ]====] diff --git a/modtools/set-need.lua b/modtools/set-need.lua index d92c564682..fcc73d2656 100644 --- a/modtools/set-need.lua +++ b/modtools/set-need.lua @@ -68,7 +68,8 @@ Other arguments: :listunit: Prints a list of all a unit's needs, their strengths, and their current focus. -Usage example - Satisfy all citizen's needs: +Usage example - Satisfy all citizen's needs:: + modtools/set-need -edit -all -focus 400 -citizens ]====] diff --git a/names.lua b/names.lua index d84530749f..f939407079 100644 --- a/names.lua +++ b/names.lua @@ -4,11 +4,9 @@ names ===== -Rename units or items. Usage: -:-help: print this help message -:-if a first name is desired press f, leave blank to clear current first name -:-if viewing an artifact you can rename it -:-if viewing a unit you can rename them +Rename units or items (including artifacts) with the native interface. +If a first name is desired, press ``f``. To clear the current first name, +leave this blank. ]====] diff --git a/putontable.lua b/putontable.lua index 2ad95d88cc..9b412d02b4 100644 --- a/putontable.lua +++ b/putontable.lua @@ -4,7 +4,9 @@ putontable ========== Makes item appear on the table, like in adventure mode shops. -Arguments: ``-a`` or ``--all`` for all items. +Arguments: + +* ``-a`` or ``--all``: apply to all items at the cursor ]====] diff --git a/setfps.lua b/setfps.lua index 7f7681be37..aea357177f 100644 --- a/setfps.lua +++ b/setfps.lua @@ -3,8 +3,12 @@ setfps ====== -Run ``setfps `` to set the FPS cap at runtime, in case you want to watch -combat in slow motion or something. +Sets the FPS cap at runtime. Useful in case you want to speed up the game or +watch combat in slow motion. + +Usage:: + + setfps ]====] diff --git a/teleport.lua b/teleport.lua index 3727787580..2a537b9eca 100644 --- a/teleport.lua +++ b/teleport.lua @@ -6,14 +6,25 @@ teleport ======== -Teleports a unit to given coordinates. Examples: +Teleports a unit to given coordinates. -:teleport -showunitid: prints ID of unit beneath cursor -:teleport -showpos: prints coordinates beneath cursor -:teleport -unit 1234 -x 56 -y 115 -z 26: - teleports unit 1234 to 56,115,26 +.. note:: -See `gui/teleport` for an in-game UI. + `gui/teleport` is an in-game UI for this script. + +Examples: + +* prints ID of unit beneath cursor:: + + teleport -showunitid + +* prints coordinates beneath cursor:: + + teleport -showpos + +* teleports unit ``1234`` to ``56,115,26`` + + teleport -unit 1234 -x 56 -y 115 -z 26 ]====] diff --git a/tidlers.lua b/tidlers.lua index e2a8c61c31..2121ffadb7 100644 --- a/tidlers.lua +++ b/tidlers.lua @@ -3,7 +3,8 @@ tidlers ======= -Toggle between all possible positions where the idlers count can be placed. +Toggle between all possible positions where the idlers count can be placed +(see ``data/init/d_init.txt`` for details). ]====] df.global.d_init.idlers = df.d_init_idlers:next_item(df.global.d_init.idlers) diff --git a/troubleshoot-item.lua b/troubleshoot-item.lua index 44d3404f76..213a6dc42f 100644 --- a/troubleshoot-item.lua +++ b/troubleshoot-item.lua @@ -4,7 +4,8 @@ troubleshoot-item ================= -Print various properties of the selected item. +Print various properties of the selected item. Sometimes useful for +troubleshooting issues such as why dwarves won't pick up a certain item. ]====] diff --git a/unforbid.rb b/unforbid.rb index efa345d104..7513936d29 100644 --- a/unforbid.rb +++ b/unforbid.rb @@ -4,9 +4,12 @@ unforbid ======== - unforbid all +Unforbids all items. - Options available: ``all``, ```help``` +Usage:: + + unforbid all + unforbid help =end diff --git a/view-item-info.lua b/view-item-info.lua index 491410b2f3..6f99e53f66 100644 --- a/view-item-info.lua +++ b/view-item-info.lua @@ -10,7 +10,7 @@ A script to extend the item or unit viewscreen with additional information including a custom description of each item (when available), and properties such as material statistics, weapon attacks, armor effectiveness, and more. -The associated script `item-descriptions`.lua supplies custom descriptions +The associated script `item-descriptions` supplies custom descriptions of items. Individual descriptions can be added or overridden by a similar script :file:`raw/scripts/more-item-descriptions.lua`. Both work as sparse lists, so missing items simply go undescribed if not defined in the fallback.