Skip to content

Commit

Permalink
release(0.1.1): update to 1.20
Browse files Browse the repository at this point in the history
  • Loading branch information
GearsDatapacks committed Jul 29, 2023
1 parent 37dfa31 commit e8a1a90
Show file tree
Hide file tree
Showing 3 changed files with 17 additions and 7 deletions.
9 changes: 8 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,11 +5,18 @@ All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]
## [0.1.1] - 2023-07-29
Update to 1.20

### Added
- Quaternion to xyz conversion

### Changed
- Now allows for {x,y,z} or [x,y,z] in conversion functions

### Fixed
- Updated fields that were changed in 1.20

## [0.1.0] - 2023-02-11
Initial release!

Expand Down
13 changes: 8 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,10 +4,13 @@ MCAnim is a Minecraft datapack library that aims to make it easy to run certain

## Current features:

- **Animation playing**\
There are four ways to play animations: `generic`, `scale`, `translate` and `rotate`. Generic allows you to apply many animations including modifying duration at the same time. Called by running first the command `data modify storage mcanim:api/display_animations/generic animation set value {}`, and replacing the `{}` with your data. This supports setting the `duration` property, which decides the length of the animation, and any other property will be treated as an animation. Scale and translate do the same, but take x, y and z properties instead. Then run the function `mcanim:api/display_animations/<function>` as the entity you want to animate, to see it play.
- **Animation playing**
There are four ways to play animations: `generic`, `scale`, `translate` and `rotate`. Generic allows you to apply many animations including modifying duration at the same time. Called by running first the command `data modify storage mcanim:api/display_animation/generic animation set value {}`, and replacing the `{}` with your data. This supports setting the `duration` property, which decides the length of the animation, and any other property will be treated as an animation. Scale and translate do the same, but take x, y and z properties instead. Then run the function `mcanim:api/display_animation/<function>` as the entity you want to animate, to see it play.

- **Rotation and quaternions**
Rotation also takes x, y and z components in degrees, but as Minecraft uses quaternions for rotation, it automatically converts the angles given into quaternions. This can be done manually by setting the `mcanim:api/maths/xyz_to_quaternion target` to `{x, y, z}`, where you give each property the desired value. Then run `function mcanim:api/maths/xyz_to_quaternion`. The result will be in `mcanim:api/maths/xyz_to_quaternion output`
- **Rotation and quaternions**
Rotation also takes x, y and z components in degrees, but as Minecraft uses quaternions for rotation, it automatically converts the angles given into quaternions. This can be done manually by setting the `mcanim:api/maths/xyz_to_quaternion target` to `{x, y, z}` or `[x, y, z]`, where you give each property the desired value. Then run `function mcanim:api/maths/xyz_to_quaternion`. The result will be in `mcanim:api/maths/xyz_to_quaternion output`

Those are all of the features currently implemented, if you would like to suggest more or report a bug, please create an issue on the github page.
The same feature exists the other way around, converting a quaternion to its x, y and z components.
Similar to the above, set `mcanim:api/maths/quaternion_to_xyz target` to `[x, y, z, w]` or `{x, y, z, w}` (w is ignored, so optional). Then run `function mcanim:api/maths/quaternion_to_xyz`. As expected, the resulting array: `[x, y, z]` is found in `mcanim:api/maths/quaternion_to_xyz output`

Those are all of the features currently implemented, if you would like to suggest more or report a bug, please create an [issue on the github page](https://github.com/GearsDatapacks/mcanim/issues).
2 changes: 1 addition & 1 deletion data/mcanim/functions/version.mcfunction
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,6 @@ data modify storage mcanim:version name set value "McAnim"

data modify storage mcanim:version major set value 0
data modify storage mcanim:version minor set value 1
data modify storage mcanim:version patch set value 0
data modify storage mcanim:version patch set value 1

tellraw @a {"nbt":"name","storage":"mcanim:version","extra":[{"text":" v","extra":[{"nbt":"major","storage":"mcanim:version","extra":[{"text":"."},{"nbt":"minor","storage":"mcanim:version"},{"text":".","extra":[{"nbt":"patch","storage":"mcanim:version"}]}]}]}]}

0 comments on commit e8a1a90

Please sign in to comment.