Wiki 9Minecraft Paragliders Wiki
Paragliders WikiDocumentation › Configurations

Configurations

This page documents the list of configs available. If some config entry is missing, please let me know.

Where's my config file?

The common config and player state config can be found inside [Minecraft Instance]/config/.

Location of the server config depends on the mod loader and version; see below chart.

Version Location
Forge [Minecraft Instance]/saves/[Save Name]/serverconfig/ (Client)
[Minecraft Instance]/world/serverconfig/ (Server)
Fabric [Minecraft Instance]/config/
NeoForge (21.x~) [Minecraft Instance]/config/

On Forge, [Minecraft Instance]/defaultconfigs/ folder allows you to set default config options for server configs as well.

Server Config (paraglider-server.toml)

This is the main config file that controls the majority of feature adjustments.

Uncategorized

  • ascendingWinds [Default: true]

Fire will float you upward.

  • windSources [Default: "fire", "campfire#lit=true", "soul_campfire#lit=true"]

You can customize which block produces wind. Write each blockstate to one of this format:

[block ID]   // Matches all state of the block.
[block ID]#[property1=value],[property2=value],[property3=value],[...]   // Matches state of the block with specified properties.

Same property cannot be specified multiple times. Wind sources with any invalid part will be excluded.

Wind source is now controlled by datapack.

  • updraft [Default: true]

If true, wind sources will generate updrafts that interact with Paraglider. Wind sources and strength (i.e. height) of the updraft created can be adjusted with datapacks. See online docs for more information.

  • paraglidingSpeed [Default: 1.0, Range: 0.2 ~ 10.0]

Multiplier to horizontal movement speed while paragliding. Value of 0.5 means 50% of the speed, 2.0 means two times the speed and so forth.

  • paragliderDurability [Default: 0, Range: 0 ~]

Durability of Paragliders. Set to zero to disable durability.

  • paragliderInTowersOfTheWild [Default: DEFAULT] Configurable option for Towers of the Wild compat feature. Can be ignored if Towers of the Wild is not installed.
  • DEFAULT: Default option, spawn Deku Leaf in ocean tower chests and Paraglider in normal tower chests
  • DISABLE: Don't spawn anything
  • PARAGLIDER_ONLY: Spawn paraglider in both ocean and normal tower chests
  • DEKU_LEAF_ONLY: Spawn deku leaf in both ocean and normal tower chests, like a boss

spiritOrbs

  • enderDragonDropsVessel [Default: true]

If true, Ender Dragon will drop heart container(stamina vessel if heart container is disabled) upon death.

The vessel reward is per-player, meaning every player participated in the fight will get one vessel each.

  • enderDragonVesselSpawnsOnPodium [Default: true]

If true, heart container/stamina vessel dropped by Ender Dragon will spawn on top of the end podium (the ending portal).

If false, it will be instead given directly to players.

This option does not change the amount of vessels given to each player. Intended as a compatibility feature for mods that change end podium location.

  • witherDropsVessel [Default: true]

If true, Wither will drop heart container(stamina vessel if heart container is disabled) upon death.

Disabling Wither Vessel drop requires either de-registering, or nullifying the effect of paraglider:wither loot modifier entry via editing.

  • raidGivesVessel [Default: true]

If true, Raids will give heart container(stamina vessel if heart container is disabled) upon victory.

The vessel reward is per-player, meaning every player participated in the Raid will get one vessel each.

  • elderGuardianDropsSpiritOrb [Default: true]

If true, Elder Guardian will drop a Spirit Orb upon death.

  • spawnerSpiritOrbDrops [Default: 2, Range: 0 ~ 64]

Amount of Spirit Orbs dropped from spawners.

  • spawnerSpiritOrbDrops [Default: 1.0, Range: 0.0 ~ 64.0]

Amount of Spirit Orbs dropped from spawners. Fractional values are treated as a chanced drop, in addition to whole values which is guaranteed to drop.

  • trialSpiritOrbDrops [Default: 2.0, Range: 0.0 ~ 64.0]

Amount of Spirit Orbs dropped from completing trial. Fractional values are treated as a chanced drop, in addition to whole values which is guaranteed to drop.

  • ominousTrialSpiritOrbDrops [Default: 4.0, Range: 0.0 ~ 64.0]

Amount of Spirit Orbs dropped from completing ominous trial. Fractional values are treated as a chanced drop, in addition to whole values which is guaranteed to drop.

  • spiritOrbLoots [Default: true]

If true, various types of chest will have chances of having Spirit Orbs inside.

Does not change contents of already generated chests.

vessels

  • startingHearts [Default: 10, Range: 1 ~ 512 1 ~ ]

Starting health points measured in number of hearts.

  • maxHeartContainers [Default: 20, Range: 0 ~ 512 0 ~ ]

Maximum amount of Heart Containers one player can consume. Do note that the maximum health point is capped at value of 1024 (or 512 hearts) by Minecraft's default attribute system; without modifying these limits, Heart Containers won't give you extra hearts beyond that.

  • maxStamina [Default: 3000, Range: 0 ~]

Maximum amount of stamina Player can get. Do note that one third of this value is equal to one stamina wheel.

  • startingStamina [Default: 1000, Range: 0 ~]

Amount of stamina Player starts with. Values higher than maxStamina doesn't work. If you want to make this value displayed as exactly one stamina wheel, you have to make this value one third of maxStamina.

Amount of stamina players start with. One full stamina wheel is equivalent to 1000 stamina.

  • maxStaminaVessels [Default: 10, Range: 0 ~]

Stamina Vessels players need to obtain max out stamina. More vessels means lesser stamina increase per vessel.

Maximum amount of Stamina Vessels one player can consume. Higher value = higher maximum stamina.

  • staminaIncreasePerVessel [Default: 200, Range: 0 ~]

Stamina increase per vessel. One full stamina wheel is equivalent to 1000 stamina.

stamina

  • paraglidingConsumesStamina [Default true]

Paragliding will consume stamina. Run /paraglider reloadPlayerStates after change.

  • runningAndSwimmingConsumesStamina [Default: false]

Certain non-paragliding actions, such as running and swimming, will consume stamina. Run /paraglider reloadPlayerStates after change.

Common config (paraglider-common.toml)

This config file contains feature toggles and debug options.

features

Easy to access switches to toggle side features on and off.

Most of them requires server restart or datapack reload. All of them, actually.

  • spiritOrbGens [Default: true]

For those who wants to remove Spirit Orbs generated in the world, more specifically...

  • Spirit Orbs generated in various chests
  • Spirit Orbs dropped by spawners and such

Note that bargain recipe for Heart Containers/Stamina Vessels will persist, even if this option is disabled.

  • heartContainers [Default: true]

For those who wants to remove entirety of Heart Containers from the game, more specifically...

  • Heart Containers obtained by "challenges" (i.e. Killing dragon, wither, raid)
  • Bargains using Heart Containers (custom recipes won't be affected)

Note that if this option is disabled while staminaVessels is enabled, "challenges" will drop Stamina Vessels instead.

  • staminaVessels [Default: true]

For those who wants to remove entirety of Stamina Vessels from the game, more specifically...

  • Bargains using Stamina Vessels (custom recipes won't be affected)
  • structures [Default: true]

For those who wants to remove all* structures added by this mod. Requires restart.

*: Note that the structures generated in other places are NOT disabled by this option, and requires a datapack to remove.

  • villageStructures [Default: true]

For those who wants to remove village structures added by this mod. Requires datapack reload.

Note that the structures generated in other places are NOT disabled by this option, and requires a datapack to remove.

Player states config (paraglider-player-states.toml)

A separate config file for adjusting player states' properties.

A player state is a state determined by the current action a player is performing. For example, while a player runs, they are in paraglider:running state. If the player stops running and stops on ground, they are now in paraglider:idle state. If the player rides a mount, they are in paraglider:on_vehicle state.

Player states have each a staminaDelta value and a recoveryDelay value. Stamina delta controls changes in stamina per tick, while recovery delay controls how many ticks the player won't be able to gain stamina after leaving the state.

  • Positive stamina delta means the player gains stamina while in the state and not under influence of recovery delay.
  • Negative stamina delta value means the player loses stamina while in the state.
  • Stamina delta of zero means neither the stamina will increase nor decrease.

The player states config file contains all player states registered, from Paraglider or an addon, and allows modifications of staminaDelta and recoveryDelay for all states.

To apply the changes made to the config, use the following command: /paraglider reloadPlayerStates

(Note that this config options are intended for advanced uses. If you simply want to disable stamina system altogether, refer to paraglidingConsumesStamina in the server config. If you want to add stamina costs to other actions such as running, refer to runningAndSwimmingConsumesStamina in the server config, as the mod already has pre-configured settings that emulates the gameplay of LoZ: BotW.)

In-game Client Settings

Although it is not exactly a "configuration", you can adjust client-side options in-game by using Paraglider Settings key (default: Ctrl + P). In the GUI, you can adjust:

  • Stamina Wheel Settings: You can adjust the position of the stamina wheel.
    • You may set an anchor to one corner of the screen, which fixes the widget on the position relative to the anchor. This option is useful for wheel placements aligned to other widgets (such as hotbar), as it will retain the distance better when game window resizes.
    • You may set the direction for extra stamina wheels. (Left, Right, Top, Bottom)
    • Some preset positions are available for quick adjustments.
  • Wind Particle Frequency: You can adjust the amount of updraft wind particles. Defaults to 100%.
  • Auto-Paragliding: If enabled, jumping off distance while holding the paraglider automatically deploys it. Defaults to ON.

Make sure to save the settings before closing.

Datapacks

Some features may require datapack for adjustment. Notably, disabling non-village structures requires a datapack to overwrite has_structure tags for the respective worldgen structure entries. On Forge and NeoForge, various loot drops can be adjusted using datapacks as well, such as adding 1 in 10 roll for spawner's Spirit Orb loot modifier to further reduce the drops, as demonstrated in ClockwerkKaiser's datapack. For other examples, refer to Paraglider's own datapack contents in the mod jar file. On Fabric, since loot modifiers are replaced with hardcoded loot injections in code, using datapack to modify these features are not possible, unfortunately.

Notably, disabling Wither Vessel drop requires either de-registering, or nullifying the effect of paraglider:wither loot modifier entry via editing. You can disable Wither Vessel drop using server config.

The usage of aforementioned spawner Vessel drop adjustment can be considered obsolete, as you can now use fractional values in the config file for the same effect. But you can still apply the same method to other loot modifier entries.

Some other features available in datapacks include:

  • Cosmetic recipes (Transforming one item to another, not consuming other ingredients; used by exchanging Paraglider with Deku Leaf, and variants of Goddess Statues.)
  • Bargain recipes (UI-based exchange system, interoperable with Heart Container and Stamina Vessel. Used by Goddess Statues and Horned Statue)
  • Bargain types (New type of bargain in addition to Goddess Statue and Horned Statue. Opening up the bargain UI requires command /paraglider bargain start or code.)
  • Wind sources (Blocks that produce updraft wind. Can match blocks with either blockstate or block tag, and adjust wind height.)
    • This option is available under server config. Adjusting wind height isn't possible, however.
  • While not being a full-fledged feature on itself, blocks added to block tag paraglider:wind_can_pass_through lets through updraft wind from below. By default, Copper Grates are in this block tag.