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.
- 그만큼 “이름” 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", "값" : "Elliot"}]
,[{ "op" : "추가하다", "길" : "/displayTitle", "값" : "Tech Lab Scientist"}]
,[{ "op": "추가하다", "길": "/scripts/-", "값": "/scripts/bookofspirits/bookofspirits_interact_support.lua" }]
]
결과:
{
"objectName" : "techlabscientist",
"colonyTags" : ["전초"],
...
"npcName" : "Elliot",
"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.
- parts: 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 “parts” array, the pattern should also have 3 parts..
{“이름” : “SunShark”, “제목” : “Large Fish Monster”, “parts” : [“상어”,”sunfish”,”sunfish”]}
Generated Monsters Patching-Support For New Types
For this example, 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",
"parts": ["beak"]
},
{
"이름": "Dragonzilla",
"제목": "Huge Biped Monster",
"parts": ["dragon"]
},
{
"이름": "Featherzilla",
"제목": "Huge Biped Monster",
"parts": ["feather"]
},
{
"이름": "Rhinozilla",
"제목": "Huge Biped Monster",
"parts": ["rhino"]
}
]
}
}
]
결과:
{
,"monsterTypes" :
{
"largeflying" : {...}
...
,"sb_hugebiped" : {
"variants" : [
{"이름" : "Birdzilla","제목" : "^red;Huge Biped Monster","parts" : ["beak"]}
,{"이름" : "Dragonzilla", "제목" : "^red;Huge Biped Monster","parts" : ["dragon"]}
,{"이름" : "Featherzilla","제목" : "^red;Huge Biped Monster","parts" : ["feather"]}
,{"이름" : "Rhinozilla","제목" : "^red;Huge Biped Monster","parts" : ["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", "parts": ["blabla1"]}
}
,{
"op": "추가하다", "길": "/monsterTypes/largequadruped/variants/-",
"값": {"이름": "New Quadruped 2","제목": "Large Quadruped Monster", "parts": ["blabla2"]}
}
]
결과:
,"monsterTypes" : { "largeflying" : {...} ... ,"largequadruped" : { "variants" : [ {"이름" : "Anthurix","접두사" : "성인", "제목" : "Large Quadruped Monster","parts" : ["화살"]} ... ,{"이름": "New Quadruped 1","제목": "Large Quadruped Monster", "parts": ["blabla1"]} ,{"이름": "New Quadruped 2","제목": "Large Quadruped Monster", "parts": ["blabla2"]}