Requirements for Datapacks

Since Bacap Addon Helper is designed primarily for Enhanced Discoveries (ED), a significant number of elements within the addon must be structured in the same way as in BACAP and ED to ensure proper functionality. A list of these elements is provided below.

1. Tiers

BACAP Addon Helper supports only standard tiers:

Tier	Advancement Description Color (color in advancement menu) and Title color in msg function	Possible Frames (Task, Goal, Challenge)	Technical Name	Message Translation Key in msg function	Description color in msg function	Possible tabs (folder names)
Task	green / #55FF55	Task	task	%1$s has made the advancement %2$s%3$s%4$s	#49DB49	Any
Goal	#75E1FF	Goal	goal	%1$s has reached the goal %2$s%3$s%4$s	#63BDD7	Any
Challenge	dark_purple / #AA00AA	Challenge	challenge	%1$s has completed the challenge %2$s%3$s%4$s	#C900C7	Any
Super Challenge	#FF2A2A	Challenge	super_challenge	%1$s has completed the super challenge %2$s%3$s%4$s	#DC2727	challenges
Root	#CCCCCC	Task	root	No message	No color	Any
Milestone	yellow / #FFFF55	Challenge	milestone	%1$s has completed every advancement in the %2$s tab, earning them the advancement %3$s%4$s%5$s	#E5E74F	bacap
Advancement Legend	gold / #FFAA00	Challenge	advancement_legend	%1$s has completed every advancement in the %2$s tab, earning them the advancement %3$s%4$s%5$s	gold / #FFAA00	bacap
Hidden	light_purple / #FF55FF	Technically any, but challenge 99% of times	hidden	%1$s has found the hidden advancement %2$s%3$s%4$s	#DE4ADC	Any

2. Tabs

BACAP Addon Helper supports only standard 16 tabs (roots):

Folder name	Display Name
adventure	Adventure
animal	Animals
bacap	B&C Advancements
biomes	Biomes
building	Building
challenges	Super Challenges
enchanting	Enchanting
end	The End
farming	Farming
mining	Mining
monsters	Monsters
nether	Nether
potion	Potions
redstone	Redstone
statistics	Statistics
weaponry	Weaponry

3. Teams

Bacap Addon Helper supports only 16 standard teams: aqua, black, blue, dark_aqua, dark_blue, dark_gray, dark_green, dark_purple, dark_red, gold, gray, green, red, white, yellow.

4. Reward Functions

Reward Functions must have the same structure as BACAP/ED

Macro Functions

Macro files must have this line: function <datapack_reward_namespace>:advancement_made_macro {adv_id:"<advancement mc path>",reward_id:"<reward id, generally adv_id without namespace>",tier:"<one of supported tiers>"}

Msg Functions

Msg files must have this line: tellraw @a {translate:"<translation key for the correspond tier>",with:[{selector:"@s"},{text:"[",color:"<tier title color>"},{translate:"<advancement title>",color:"<tier title color>",hover_event:{action:"show_text",value:{translate:"<advancement title>",color:"<tier title color>",extra:[{text:"\n"},{translate:"<advancement description>",color:"<advancement description color>"},{text:"\n\n"},{translate:"%1$s tab",with:[{translate:"<advancement tab display name>"}],color:"gray",italic:true}]}}},{text:"]",color:"<tier title color>"}]}

Experience Functions

Experience files must have these lines:

• Tellraw line with such syntax: tellraw @s {text:" +<exp count> ",color:"blue",extra:[{translate:"Experience"}]}
• Exp line with such syntax: xp add @s <exp count>

Item Reward Functions

Each item reward has this two lines:

• Tellraw line with such syntax: tellraw @s {text:" +<count> ",color:"green",extra:[{translate:"<item translation key>"}]}
• Give line with such syntax: give @s <item_id>[<optional item components>

Trophy Functions

Each trophy has this two lines:

• Tellraw line with such syntax: tellraw @s {text:" +<count> ",color:"gold",extra:[{translate:"<trophy title>"}]}
• Give line with such syntax: give @s <item_id>[<any other item components>, minecraft:custom_name={translate:"<trophy title>",color:"<trophy color>",bold:true,italic:false}, minecraft:lore=[{translate:"<Trophy description line 1>",color:"#B0CCD8"},{translate:"<Trophy description line 2>",color:"#B0CCD8"},{text:" "},{translate:"Awarded for achieving",color:"gray"},{translate:"<advancement title>",color:"#FF55FF",italic:false}], minecraft:custom_model_data={strings:["<unique custom model data made from trophy title (here it can be "bacaped:advancement_s_stairs"]}, minecraft:custom_data={Trophy:1}] Bacap Addon Helper also supports summon trophies, in that case it will look like this:
• Tellraw line with such syntax: tellraw @s {text:" +<count> ",color:"gold",extra:[{translate:"<trophy title>"}]}
• Second tellraw line with description tellraw @s {translate:" The trophy appeared at the place of your death",color:"gray"}
• Summon line with such syntax: summon minecraft:item ~ ~ ~ {Invulnerable:true,Item:{id:"<item_id>",count:1,components:{"minecraft:lore":[{translate:"<trophy description line 1>",color:"<trophy description color>"},{text:" "},{translate:"Awarded for achieving",color:"gray"},{translate:"<trophy title>",color:"#75E1FF",italic:false}],"minecraft:custom_name":{translate:"<advancement title>",color:"#F6FFDF",bold:true,italic:false},"minecraft:custom_model_data":{strings:["<unique custom model data made from trophy title (here it can be "bacaped:advancement_s_stairs>"]},"minecraft:custom_data":{Trophy:1}}}}

5. Misc values

• Bacap Addon Helper supports update_score, update_points, etc. but only with standard scoreboard names: bac_advancements for update_score, bac_advancements_points for update_points, bac_obtained for general advancement coop syncing (coop_update, coop_update_team_{team_name} and grant_trophies, bac_points for points values.
• bacap_fanpacks scoreboard for Fanpacks tag generation
• Default divider used in timers, statistics triggers: (this is a line of spaces yes), with dark_gray color.