Back to top

The following entries are settings that any player can use and configure, no matter the conditions:

• Enable Tribe Abilities: Toggle on or off your hotbar abilities. (Default: OFF)
  • ON: Player is able to use active abilities freely. They may disable them at any point.
  • OFF: Player is unable to use active abilities. They may enable them at any point.
    
    
• Enable Tribe Attributes: Toggle on or off your tribe's attributes and any passive abilities. (Default: OFF)
  • ON: Player benefits from the passive effects of their current tribe. They may disable them at any point.
  • OFF: Player is unaffected by any tribe's passive effects. They may enable them at any point.
    
    
• Enable Range Display: Toggle on or off the range preview for your held ability. (Default: OFF)
  • ON: Player receives visual feedback of the range/range type of their held ability. They may disable this feedback at any point.
  • OFF: Player no longer sees their held ability's range preview. They may enable this feedback at any point.
    
    
• Enable PVP: Toggle on or off the ability to harm entities via abilities and/or the effects of their abilities. (Default: ON)
  • ON: Player can deal and take damage from all abilities and can be afflicted by any potential custom effects. They may disable this at any point.
  • OFF: Player no longer has any interaction with any abilities or custom effects. They may enable this at any point.
    
    
• Ability Handling: Choose what happens when an ability item is replaced with another item. (Default: Remove Abilities)
  • Remove Abilities: Player's abilities are automatically disabled when a non-ability item enters a slot occupied by an ability item.
  • Remove Items: Player's attempt to replace an ability item with a non-ability item results in the non-ability item being dropped at their feet.
    
    

Back to top

The following entries are settings that only players with the eoflib.admin tag can change:

• Persistent Settings: Keep your settings when the world is reloaded in any way. (Default: ON)
  • ON: Admin Settings and Uninstall Settings stay as-configured when the /reload command is ran or the world is otherwise reloaded.
  • OFF: Admin Settings and Uninstall Settings are set to the default, recommended settings on world reloading.
    • Default: Admin Settings and Uninstall Settings are immediately set to their defaults.
      
      
• Allow Abilities: Toggle the ability for non-admin players to toggle their abilities. (Default: ON)
  • ON: Players are able to freely toggle on or off their tribe abilities. Players must reenable their setting when Allow Abilities is changed from OFF to ON.
  • OFF: Players are no longer able to toggle on their tribe abilities, and all players have their abilities disabled.
    • Blacklist: Edit the Ability Blacklist.
      
      
• Allow Attributes: Toggle the ability for non-admin players to toggle their tribe attributes. (Default: ON)
  • ON: Players are able to freely toggle on or off their tribe attributes. Players must reenable their setting when Allow Attributes is changed from OFF to ON.
  • OFF: Players are no longer able to toggle on their tribe attributes, and all players have their attributes disabled.
    
    
• Allow Range Display: Toggle the ability for non-admin players to toggle Range Display. (Default: OFF)
  • ON: Players are able to freely toggle on or off their ability's range display. Players must reenable their setting when Allow Range Display is changed from OFF to ON.
  • OFF: Players are no longer able to toggle on their ability's range display, and all players have their ability's range display disabled.
    
    
• Allow PVP: Toggle the ability for non-admin players to toggle PVP. (Default: On)
  • ON: Players are able to freely toggle on or off Elytras of Fire-based PVP. Players must reenable their setting when Allow PVP is changed from OFF to ON.
  • OFF: Players are no longer able to toggle on PVP, and all players have PVP disabled.
    
    
• Enable Deactiviation Timer (unreleased): The Deactivation timer automatically disables abilities for players who are not actively using them. Enable this option to decrease performance impact of Elytras of Fire Lib and any installed DLCs. (Default: OFF)
  • ON: Players who have not actively used their ability during a period of time will automatically have them disabled.
  • OFF: Players will keep their abilities active regardless of ability inactivity.
    
    
• Enable Destructive Effects: Toggle the destructive properties that some abilities come with. (Default: OFF)
  • ON: Abilities can cause physical damage to some terrain, structures, buildings, etc.
  • OFF: Abilities will cause no damage to the environment and will only affect entities.
    
    
• Custom Death Messages (unreleased): Toggle custom death messages when players are killed by certain abilities. (Default: ON)
  • ON: Deaths caused by certain abilities will give a datapack-generated death message. Purely cosmetic.
  • OFF: Deaths by abilities will not yield new death messages.
    
    
• Enable Friendly Fire (unreleased): Toggle friendly fire for most abilities. (Default: OFF)
  • ON: Players are able to freely toggle on or off friendly fire.
  • OFF: Players are no longer able to toggle on friendly fire, and ability effects can be taken from any source.
    
    
• Cooldown Bypass: Allows you to bypass all tribe ability cooldowns. (Default: OFF)
  • ON: User will bypass all cooldowns imposed by abilities.
  • OFF: User is penalised by ability cooldowns on successful use.
    
    
• Debug Mode: Displays helpful information in-game to streamline datapack development and show function references and sources. (Default: OFF)
  • ON: User will receive debugging messages in chat.
    • 0: Debug Mode is soft disabled.
    • 1: User will see only load/uninstall messages.
    • 2: All general one-call functions called by the user.
    • 3: All general one-call functions called by the user and other command sources.
    • 4: Condiionally-looping functions.
    • 5: All function calls.
  • OFF: User will see no technical messages.

Back to top

The following entries are settings that only players with the eoflib.admin tag can change:

• Keep Forceloads: Toggle whether forceloaded chunks stay forceloaded after this datapack is uninstalled. (Default: ON)
  • ON: Forceloaded chunks will remain forceloaded after uninstall.
  • OFF: Forceloaded chunks will no longer be forceloaded during uninstall.
    
    
• Keep Storages: Keep all storage data intact when this datapack is uninstalled. (Default: ON)
  • ON: Storage data will remain after uninstall.
  • OFF: Relevant storage data will be removed during uninstall.
    
    
• Keep Bossbars: Keep all bossbars intact when this datapack is uninstalled. (Default: ON)
  • ON: Bossbars will remain after uninstall.
  • OFF: Bossbars will be removed during uninstall.
    
    
• Keep Teams: Keep all tribe teams intact when this datapack is uninstalled. (Default: ON)
  • ON: Teams will remain after uninstall.
  • OFF: Teams will be removed during uninstall.
    
    
• Keep Scoreboards: Keep all scoreboard objectives and data intact when this datapack is uninstalled. (Default: ON)
  • ON: Scoreboards will remain after uninstall.
  • OFF: Scoreboard objectives and data will be removed during uninstall.
    
    
• Uninstall Mode: Toggles the display of these settings when the datapack's uninstall function is called. (Default: OFF)
  • ON: Any user uninstalling the datapack will be queried if they would like to review the uninstall settings. If not, they may proceed with uninstalling (NOT RECOMMENDED!).
  • OFF: Any user uninstalling the datapack will have the Uninstall Settings displayed to them. They may be toggled during this phase, along with an easily accessible uninstall button once their settings are as fit.

Back to top

Advancements located here deal with resolving blacklist operations. By default, 2 files are included: cancel_operation, which cancels the current active blacklist operation, and register_ability, which registers a thrown ability to the blacklist. Do not overwrite/add these files to Elytras of Fire Lib.

📦 eoflib:advancements
└ 📁 blacklist
  ├ 📄 cancel_operation.json
  └ 📄 register_ability.json

ability_activated.json is an advancement that is rewarded to players who have right-clicked their ability item — not necessarily activating said ability, but solely using the item. ability_activated.json can be hooked into by adding your functions to your datapack's eoflib:reset/abilities.json function tag. Do not overwrite/add the file to Elytras of Fire Lib.

📦 eoflib:advancements
└ 📄 ability_activated.json

death.json is an advancement that is rewarded to players who have died. death.json can be hooked into by adding your functions to your datapack's eoflib:tags/functions/death.json function tag. Do not overwrite/add the file to Elytras of Fire Lib.

📦 eoflib:advancements
└ 📄 death.json

dragon.json is an advancement that is rewarded under either of the following conditions: when a player joins a team that is recognised by any datapack as an Elytras of Fire team, or when a player is given a tag matching the name of an Elytras of Fire team. Do not overwrite/add the file to Elytras of Fire Lib.

📦 eoflib:advancements
└ 📄 dragon.json

ignited.json is an advancement that is rewarded when a player is damaged by fire. ignited.json can be hooked into by setting this advancement as a parent to any other advancement you'd like. Do not overwrite/add the file to Elytras of Fire Lib.

{
  "parent": "eoflib:ignited",
  ...
}

📦 eoflib:advancements
└ 📄 ignited.json

new_id.json is an advancement that is rewarded to players who have joined the server for the first time since the datapack's loading. It assigns every player a unique score that can be used to distinguish between players, separate ability users from targets, and so on. new_id.json can be hooked into by adding your functions to your datapack's eoflib:tags/functions/new_id.json function tag. Do not overwrite/add the file to Elytras of Fire Lib.

{
  "replace": false,
  "values": [
    "namespace:function/path/here",
    ...
  ]
}

📦 eoflib:advancements
└ 📄 new_id.json

projectile_fired.json is an advancement that is activated when a player projectile_fireds the server. Most commonly, this is used to reactivate schedules that require players present on the server such as tribe effects and passive abilities. projectile_fired.json can be hooked into by adding your functions to your datapack's eoflib:tags/functions/projectile_fired.json function tag. Do not overwrite/add the file to Elytras of Fire Lib.

{
  "parent": "eoflib:projectile_fired",
  ...
}

📦 eoflib:advancements
└ 📄 rejoin.json

rejoin.json is an advancement that is activated when a player rejoins the server. Most commonly, this is used to reactivate schedules that require players present on the server such as tribe effects and passive abilities. rejoin.json can be hooked into by adding your functions to your datapack's eoflib:tags/functions/rejoin.json function tag. Do not overwrite/add the file to Elytras of Fire Lib.

{
  "parent": "eoflib:rejoin",
  ...
}

📦 eoflib:advancements
└ 📄 rejoin.json

ricardo_report.json is an advancement used by this library to detect if something has gone horribly wrong. It handles the event in which a player either throws or eats Ricardo the Error potato, sending the player a bug report form in chat along with the opportunity to bid Ricardo farewell.

📦 eoflib:advancements
└ 📄 ricardo_report.json

root.json is an advancement that is rewarded to players who have joined the server for the first time since the datapack's loading. It is simply used to detect that the datapack has loaded. Do not overwrite/add the file to Elytras of Fire Lib.

{
  "parent": "eoflib:root",
  ...
}

📦 eoflib:advancements
└ 📄 root.json

trigger.json is an advancement that is rewarded to players who have triggered certain scoreboard events.**

📦 eoflib:advancements
└ 📄 trigger.json

Back to top

ricardo.json is a loot table that creates a poisonous potato named Ricardo the Error Potato. He's a cute little guy with big, round eyes, a well-kept mustache, and a black-as-coals top hat! Ricardo is meant to be a bug item; if Ricardo is accidentally — or on purpose — given to a player, he lets them know to submit a bug report.

📦 eoflib:loot_tables
└ 📁 commands
  └ 📄 ricardo.json

shulker_box.json is a loot table that manipulates shulkers to drop their contents if an item with specific NBT is used to break it. Use any item or /loot mine command that has the {items: 1b} tag to obtain only the contents of the shulker box.

📦 minecraft:loot_tables
└ 📁 blocks
  └ 📄 shulker_box.json

Back to top

Predicates located here deal with tribal abilities being used and/or activated. By default, 4 files are included: any_used.json checks if any ability has been used (right clicked), and primary.json, secondary.json, and tertiary.json all check if their respective archetype of ability has been activated.

📦 eoflib:predicates
└ 📁 abilities
  ├ 📄 any_used.json
  ├ 📄 primary_activated.json
  ├ 📄 secondary_activated.json
  └ 📄 tertiary_activated.json

Predicates located here deal with damage. By default, 3 files are included: minimum.json checks if an entity has dealt at least one point of damage, on_fire.json checks if an entity is on fire, and recent.json checks if an entity has recently taken damage.

📦 eoflib:predicates
└ 📁 damage
  ├ 📄 minimum.json
  ├ 📄 on_fire.json
  └ 📄 recent.json

Predicates located here deal with entity grouping. By default, 2 files are included: affected.json and recent.json, which both check if a given entity is or is not allowed to be affected by abilities.

📦 eoflib:predicates
└ 📁 entities
  ├ 📄 affected.json
  └ 📄 unaffected.json

Predicates located here deal with checking if a player's ability slots are unoccupied. By default, 3 files are included, each checking a specific hotbar slot to see if it is unoccupied.

📦 eoflib:predicates
└ 📁 inventory
  └ 📁 ability
    ├ 📄 primary_empty.json
    ├ 📄 secondary_empty.json
    └ 📄 tertiary_empty.json

Predicates located here deal with inventory checking. By default, 9 files are included, each checking a specific hotbar slot to see if it is unoccupied.

📦 eoflib:predicates
└ 📁 inventory
  └ 📁 hotbar
    ├ 📄 slot_0_empty.json
    ├ 📄 slot_1_empty.json
    ├ 📄 slot_2_empty.json
    ├ 📄 slot_3_empty.json
    ├ 📄 slot_4_empty.json
    ├ 📄 slot_5_empty.json
    ├ 📄 slot_6_empty.json
    ├ 📄 slot_7_empty.json
    └ 📄 slot_8_empty.json

Predicates located here deal with checking the player's mainhand. By default, 4 files are included, each checking the player's mainhand for any/a specific archetype of ability.

📦 eoflib:predicates
└ 📁 inventory
  └ 📁 mainhand
    └ 📁 ability
      ├ 📄 any.json
      ├ 📄 primary.json
      ├ 📄 secondary.json
      └ 📄 tertiary.json

Predicates located here deal with location checking. By default, 2 files are included: submerged_in_water.json checks for players that are completely encompassed in water (or waterlogged blocks) and water.json checks for players standing on or in water (or waterlogged blocks.)

📦 eoflib:predicates
└ 📁 location
  ├ 📄 submerged_in_water.json
  └ 📄 water.json

Predicates located here deal with movement checking. By default, 6 files are included, each checking for general and player-specific movement types.

📦 eoflib:predicates
└ 📁 movement
  ├ 📄 elytra_flight.json
  ├ 📄 ground_sneak.json
  ├ 📄 on_ground.json
  ├ 📄 sneak.json
  ├ 📄 sprint.json
  └ 📄 swim.json

Predicates located here deal with defining admin settings. By default, 13 files is included.

📦 eoflib:predicates
└ 📁 settings
  └ 📁 admin
    ├ 📁 debug_mode
    │ ├ 📄 highest_tier.json
    │ └ 📄 lowest_tier.json
    ├ 📄 ability_timer.json
    ├ 📄 allow_abilities.json
    ├ 📄 allow_attributes.json
    ├ 📄 allow_pvp.json
    ├ 📄 allow_range_display.json
    ├ 📄 cooldown_bypass.json
    ├ 📄 custom_deaths.json
    ├ 📄 destructive_abilities.json
    ├ 📄 friendly_fire.json
    ├ 📄 in_blacklist_operation.json
    └ 📄 save_settings.json

Predicates located here deal with tribe checking. By default, only 1 file is included.

📦 eoflib:predicates
└ 📁 settings
  └ 📁 uninstall
    ├ 📄 bossbars.json
    ├ 📄 forceloads.json
    ├ 📄 scoreboards.json
    ├ 📄 storages.json
    └ 📄 teams.json

Predicates located here deal with tribe checking. By default, only 1 file is included.

📦 eoflib:predicates
└ 📁 tribes
  └ 📄 dragon.json

Back to top

Tags here group blocks by their respective titles. By default, 6 files are included: carpet.json groups carpet-like blocks, earth_blocks.json groups earthy/silty and natural blocks, hot.json groups hot blocks, ice.json groups icy blocks, snow.json groups blocks associated with snow, and waterlogged.json groups blocks that are able to be waterlogged.

📦 eoflib:tags
└ 📁 blocks
  ├ 📄 carpet.json
  ├ 📄 earth_blocks.json
  ├ 📄 hot.json
  ├ 📄 ice.json
  ├ 📄 snow.json
  └ 📄 waterlogged.json

climbable.json adds to Minecraft's own climbable.json block tag. Because there is no way (that I am more willing to do) to make custom block tags climbable, this is the only overwrite Elytras of Fire Lib does to the Minecraft namespace.

📦 minecraft:tags
└ 📁 blocks
  └ 📄 climbable.json

Tags here group blocks commonly found composing Minecraft deserts. By default, 5 related files are included.

📦 eoflib:tags
└ 📁 blocks
  ├ 📄 desert.json
  └ 📁 desert
    ├ 📄 sand.json
    ├ 📄 sandstone.json
    └ 📁 sandstone
      ├ 📄 red.json
      └ 📄 white.json

Tags here group blocks best described as flora. They are further grouped by dimension and general distinction (grasses, mosses, vines, etc.) By default, 12 related files are included.

📦 eoflib:tags
└ 📁 blocks
  ├ 📄 flora.json
  └ 📁 flora
    ├ 📄 dripleaf.json
    ├ 📄 grass.json
    ├ 📄 moss.json
    ├ 📄 mushrooms.json
    ├ 📄 vines.json
    ├ 📁 mushrooms
    │ ├ 📄 block.json
    │ └ 📄 small.json
    ├ 📁 nether
    │ ├ 📄 grass.json
    │ └ 📄 vines.json
    └ 📁 overworld
      ├ 📄 grass.json
      └ 📄 vines.json

Tags here group blocks that emit light sources. By default, 3 related files are included.

📦 eoflib:tags
└ 📁 blocks
  ├ 📄 light.json
  └ 📁 light
    ├ 📄 block.json
    └ 📄 small.json

Tags here group blocks that are meant to replace or add to the default Minecraft tags in terms of usage. As it is good practice to not overwrite default tags unless it is unavoidable, these are simply here to abide by this practice. By default, 13 files are included.

📦 eoflib:tags
└ 📁 blocks
  └ 📁 minecraft
    ├ 📄 air.json
    ├ 📄 amethyst.json
    ├ 📄 coral_fans.json
    ├ 📄 corals.json
    ├ 📄 dirt.json
    ├ 📄 fire.json
    ├ 📄 flowers.json
    ├ 📄 froglights.json
    ├ 📄 glass_panes.json
    ├ 📄 gravel.json
    ├ 📄 redstone_components.json
    ├ 📄 sand.json
    └ 📄 torches.json

Tags here group blocks that raycast abilities can pass through. By default, 2 related files are included.

📦 eoflib:tags
└ 📁 blocks
  └ 📁 passable
    ├ 📄 general.json
    └ 📄 water.json

Back to top

projectiles.json groups entities used as projectiles by any entity or block.

📦 eoflib:tags
└ 📁 entities
  └ 📄 projectiles.json

unaffected.json groups entities that are unable to be affected by any vanilla Minecraft effects.

📦 eoflib:tags
└ 📁 entities
  └ 📄 unaffected.json

Back to top

config.json is used by Elytras of Fire Lib and other DLCs to run configuration settings provided by them.

📦 eoflib:tags
└ 📁 functions
  └ 📄 config.json

detect_dlcs.json is used by Elytras of Fire Lib and other DLCs to detect other DLCs.

📦 eoflib:tags
└ 📁 functions
  └ 📄 detect_dlcs.json

dlc_load.json is used by Elytras of Fire Lib and other DLCs to load themselves and/or other DLCs.

📦 eoflib:tags
└ 📁 functions
  └ 📄 dlc_load.json

uninstall.json is used by Elytras of Fire Lib and other DLCs to uninstall themselves and/or other DLCs.

📦 eoflib:tags
└ 📁 functions
  └ 📄 uninstall.json

Tags here group functions to be ran only once by Elytras of Fire Lib or other DLCs. By default, 8 files are included.

📦 eoflib:tags
└ 📁 functions
  └ 📁 load
    ├ 📁 del
    │ ├ 📄 forceloads.json
    │ ├ 📄 scoreboards.json
    │ ├ 📄 storage.json
    │ └ 📄 teams.json
    └ 📁 gen
      ├ 📄 forceloads.json
      ├ 📄 scoreboards.json
      ├ 📄 storage.json
      └ 📄 teams.json

Tags here group functions to be ran when resetting certain aspects of Elytras of Fire Lib. By default, 1 file is included.

📦 eoflib:tags
└ 📁 functions
  └ 📁 reset
    └ 📄 tribe_advancements.json

Tags here group functions to be ran on a regular schedule. By default, 4 files are included.

📦 eoflib:tags
└ 📁 functions
  └ 📁 timer
    ├ 📄 1t.json
    ├ 📄 5t.json
    └ 📄 10t.json
    └ 📄 20t.json

Back to top

items.json is used by Elytras of Fire Lib and other DLCs to group items used by them.

📦 eoflib:tags
└ 📁 functions
  └ 📁 items
    └ 📄 items.json