Skip to content

docs: add flying a winged animal form - #22

Merged
Kheartz merged 1 commit into
hogwarts-mp:mainfrom
Kheartz:animal-form-flight
Oct 25, 2026
Merged

Kheartz merged 1 commit into
hogwarts-mp:mainfrom
Kheartz:animal-form-flight

Conversation

@Kheartz

@Kheartz Kheartz commented Oct 25, 2026

Copy link
Copy Markdown
Member

Adds a Flying subsection to the Animal forms section of the Appearance guide, for the frequent question of how to make a winged form fly.

It covers:

  • that a form gives a flier its poses but no flight, so a client script flies the local player;
  • how the poses follow: every game watches the ground under a flier, takes off above 1.2 m, lands within 40 cm and faces the way it moves, so anything that lifts a flier (a script, a teleport, a launch) gets them;
  • a server sample: a /fly command that checks canFly in Beast.catalog(), scales speed with the form's size and tells the client to take off or land;
  • a client sample: stopPlayerInput and setCollision(false), steps steered by Camera.capture() and Key.isDown, a World.lineTrace to stop short of walls, and a landing at the takeoff height with resetFall();
  • landing a flier before turning them back or when they die.

The existing "does not lift them there" line links to it, and the guide's description and overview entry mention flying.

docs:check passes locally: 226 samples in 56 guides against the 1.10.0 contract.

The form gives a flier its poses but no flight, so the Animal forms section now shows a client script flying the local player, steered by the camera and keys, and landing them without a fall.
@Kheartz
Kheartz merged commit 9c91861 into hogwarts-mp:main Oct 25, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant