This guide is about fixing the Starbound mod called Book of Spirits – NPC & Monster Name Displayer. The goal is to include built-in assistance for custom NPCs, モンスター, and talkative objects.
概要
This mod is crucial, and it should be loaded before any other mods using its features. You don’t have to include it in your metadata file. The key features involve showing the name of the entity, a custom title if it has one, and for monsters, indicating if they are rare breeds (like Albino Poptop, Fire Gleap) and elite.
There are two displayers: a name displayer and a title displayer. They automatically show based on the entity’s configuration, which I’ll explain in the sections below.
Even if I say something is harmless, it means your mod will work fine even without “Book of Spirits – NPC & Monster Name Displayer” インストールされています. It’s recommended to unpack the mod because there are files you might need to copy into your mod, helping you understand what to patch.
Naming rules for hostile NPCs: I’ve set a fixed name for generic hostile NPCs (山賊, ゾンビ, lackeys, 等) since in most video games, only important hostile NPCs have names to highlight their significance over regular mobs.
NPC parameters
The name displayer chooses the NPC’s name from one of these configurations:
- の “npcname” 変数.
- の “名前” variable that can be assigned within their identity table.
- The randomly generated name assigned to them.
It’s a personal choice, but you might want to set a name for generic hostile NPCs (ゾンビ, 盗賊, Lackeys, 等) that function as monsters.
For the title displayer, it selects the following variable added by this mod, which is harmless:
- displayTitle
There’s also a new harmless behavior script added by this mod. If an NPC is overriding the base behavior script (like Merchants, 例えば), you should copy this script:
/scripts/bookofspirits/bookofspirits_interact_support.lua
This script displays the displayer when interacting (pressing ‘E’) with an NPC. If the displayer doesn’t show up during interaction, you need to add this script to your NPC.
NPC Patching-Support
The patching process is as follows, but you can add it directly to your mod for easier understanding of variable positions.
To give an NPC a title, and if it’s overriding the behavior script (例えば, merchant.npctype):
[
[{ "op" : "追加", "パス" : "/displayTitle", "価値" : "商人"}]
,[{ "op": "追加", "パス": "/scripts/-", "価値": "/scripts/bookofspirits/bookofspirits_interact_support.lua" }]
]
結果:
{
"タイプ" : "merchant",
"baseType" : "ベース",
...
"displayTitle" : "商人",
"スクリプト" : [
"/npcs/bmain.lua"
,"/scripts/bookofspirits/bookofspirits_interact_support.lua"
]
}
To set a fixed name for the npc(mutantminer.npctype):
[{ "op" : "追加", "パス" : "/identity", "価値": { "名前":"Mutant Miner" }}]
結果:
{
"identity" :
{
"名前":"Mutant Miner"
}
}
Chatty Objects Parameters
The following variables and script are harmless additions from this mod:
For the name displayer, it uses the following object configuration as their NPC name:
- npcName
The title displayer selects the following harmless variable added by this mod:
- displayTitle
There’s also a new script that you must copy into your mod:
/scripts/bookofspirits/bookofspirits_interact_support.lua
This script displays the displayer when interacting (pressing ‘E’) with an object. If the displayer doesn’t show up during interaction, you need to add this script to your object.
警告:
- You cannot use this feature if the object has an “interactAction” パラメーター.
- This feature is only applicable if the object can be made “chatty,” typically having “スクリプト” と “chatOptions” arrays.
Chatty Object Patching-Support
To give an object a name and title(IE: techlabscientist.object):
[
[{ "op" : "追加", "パス" : "/npcName", "価値" : "エリオット"}]
,[{ "op" : "追加", "パス" : "/displayTitle", "価値" : "Tech Lab Scientist"}]
,[{ "op": "追加", "パス": "/scripts/-", "価値": "/scripts/bookofspirits/bookofspirits_interact_support.lua" }]
]
結果:
{
"objectName" : "techlabscientist",
"colonyTags" : ["前哨基地"],
...
"npcName" : "エリオット",
"displayTitle" : "Tech Lab Scientist",
"スクリプト" : ["/scripts/chattyObject.lua","/scripts/bookofspirits/bookofspirits_interact_support.lua"]
}
Monster Parameters
For the name displayer, it selects the following configuration of the monster as their name:
- shortdescription
The title displayer picks the following harmless variable added by this mod, added as a statusProperties:
- displayTitle
ノート: Rare monster variants have a custom title in the format (check /monsters/flyers/agrobat/iceagrobat.monstertype.patch):
^yellow; Rare Breed ^reset;
さらに, there’s a new harmless script added by this mod. You must copy it if there’s a monster that can be set as elite or can have dynamic custom titles and dynamic names, such as Generated monsters:
/scripts/bookofspirits/bookofspirits_monster_support.lua
There’s also a new file containing additional configurations for Generated Monsters. If you’re adding new types of generated monsters, check this file for more details:
/monsters/bookofspirits_generated.config
Monster Patching-Support
To give a Monster a name, title and display it as elite if is configured as elite(IE: punchy.monstertype):
[
[{ "op" : "追加", "パス" : "/shortdescription", "価値" : "Punchy"}]
,[{ "op" : "追加", "パス" : "/baseParameters/statusSettings/statusProperties/displayTitle", "価値" : "Test Dummy"}]
,[{ "op" : "追加", "パス" : "/baseParameters/scripts/-", "価値" : "/scripts/bookofspirits/bookofspirits_monster_support.lua"}]
]
結果:
{
"タイプ" : "punchy",
"カテゴリ" : [],
...
"shortdescription" : "Punchy",
"baseParameters" : {
"statusSettings" : {
"statusProperties" : {
"displayTitle" : "Test Dummy"
}
}
,"スクリプト" : [
"/monsters/monster.lua",
,"/scripts/bookofspirits/bookofspirits_monster_support.lua"
]
}
}
Generated Monster Parameters
Generated Monsters have a dedicated configuration file that includes parameters for setting the name and custom title based on their parts. The configuration file is located at:
/monsters/bookofspirits_generated.config
さらに, there’s a new script at “/scripts/bookofspirits/bookofspirits_monster_support.lua” that must be copied into your mod. Make sure to add this script to the script array of the generated monster.
skillPrefixes
Here’s a JSON array of objects containing a list of skill types from the special skill of the monster. This list is used to determine the prefix of the monster name.
- 名前: This is the string name that will be displayed alongside the monster name.
- skillName: This is the skill name type (例えば, inkSprayAttack) that will be used to compare if the monster has that skill.
- asSuffix (オプション): If set to true, the skill name will be added after the monster name.
monsterTypes
This list contains the names of monster types and their variants. It’s used to determine the monster name and title based on the head part of the monster or a specific part pattern of your choice.
- monster type (例えば, “largeflying”): The name of the list should match the “タイプ” parameter in the .monstertype file.
- variants: In this JSON array of objects, you include different part combinations that the generated monster can have.
Variants Parameters
This JSON array of objects includes variables used to configure the generated monster name and title based on the given parts. It supports multiple part patterns, but it’s recommended to prioritize entries with just the head part first.
- 名前: The monster name that will be displayed.
- タイトル (オプション): The title that will be displayed.
- 接頭語 (オプション): A prefix added to the monster name.
- 部品: An array of strings containing the names of folders containing the monster’s parts.
- addSkillPrefix (オプション): If set to false, it won’t add a skill prefix to the monster name.
ノート:
- If you want to set a specific pattern, that entry must include all the part types used by the monster type.
- 例えば, もし “largefish” 用途 3 parts as configured in its “部品” 配列, the pattern should also have 3 parts..
{“名前” : “SunShark”, “タイトル” : “Large Fish Monster”, “部品” : [“サメ”,”sunfish”,”sunfish”]}
Generated Monsters Patching-Support For New Types
この例の場合, I’ll use the “sb_hugebiped.monstertype” from Betabound, which is a new type of generated monster.
Remember to copy “/scripts/bookofspirits/bookofspirits_monster_support.lua” into your mod in the same folder path.
To provide support for a new generated monster type (add it directly to your mod or patch it if you are patching another user’s mod):
[
[{ "op" : "追加", "パス" : "/baseParameters/scripts/-", "価値" : "/scripts/bookofspirits/bookofspirits_monster_support.lua"}]
]
結果:
{
"タイプ" : "sb_hugebiped",
"カテゴリ" : ["sb_hugebiped"],
...
,"baseParameters" : {
"スクリプト" : [
"/monsters/monster.lua",
"/monsters/sb_miniboss.lua"
,"/scripts/bookofspirits/bookofspirits_monster_support.lua"
]
}
}
Then you must patch the file “/monsters/bookofspirits_generated.config” as a file “/monsters/bookofspirits_generated.config.patch“:
[
{
"op": "追加",
"パス": "/monsterTypes/sb_hugebiped",
"価値": {
"variants": [
{
"名前": "Birdzilla",
"タイトル": "Huge Biped Monster",
"部品": ["beak"]
},
{
"名前": "Dragonzilla",
"タイトル": "Huge Biped Monster",
"部品": ["dragon"]
},
{
"名前": "Featherzilla",
"タイトル": "Huge Biped Monster",
"部品": ["feather"]
},
{
"名前": "Rhinozilla",
"タイトル": "Huge Biped Monster",
"部品": ["rhino"]
}
]
}
}
]
結果:
{
,"monsterTypes" :
{
"largeflying" : {...}
...
,"sb_hugebiped" : {
"variants" : [
{"名前" : "Birdzilla","タイトル" : "^red;Huge Biped Monster","部品" : ["beak"]}
,{"名前" : "Dragonzilla", "タイトル" : "^red;Huge Biped Monster","部品" : ["dragon"]}
,{"名前" : "Featherzilla","タイトル" : "^red;Huge Biped Monster","部品" : ["feather"]}
,{"名前" : "Rhinozilla","タイトル" : "^red;Huge Biped Monster","部品" : ["rhino"]}
]
}
}
}
Generated Monster Patching-Support Existing Type
To add a new variant to an existing monster type(IE: largequadruped.monstertype), you must patch the file “/monsters/bookofspirits_generated.config” as a file “/monsters/bookofspirits_generated.config.patch“:
[
{
"op": "追加", "パス": "/monsterTypes/largequadruped/variants/-",
"価値": {"名前": "New Quadruped 1","タイトル": "Large Quadruped Monster", "部品": ["blabla1"]}
}
,{
"op": "追加", "パス": "/monsterTypes/largequadruped/variants/-",
"価値": {"名前": "New Quadruped 2","タイトル": "Large Quadruped Monster", "部品": ["blabla2"]}
}
]
結果:
,"monsterTypes" : { "largeflying" : {...} ... ,"largequadruped" : { "variants" : [ {"名前" : "Anthurix","接頭語" : "アダルト", "タイトル" : "Large Quadruped Monster","部品" : ["矢印"]} ... ,{"名前": "New Quadruped 1","タイトル": "Large Quadruped Monster", "部品": ["blabla1"]} ,{"名前": "New Quadruped 2","タイトル": "Large Quadruped Monster", "部品": ["blabla2"]}