AnimatedFrames allows you to play animations on item frames!
- Tested Minecraft Versions:
- 1.16
- Source Code:
- https://github.com/InventivetalentDev/AnimatedFrames
- Languages Supported:
- Custom
- Donation Link:
- https://www.patreon.com/inventivetalent
If you find this plugin useful, feel free to throw over a donation
Depends on PacketListenerAPI & MapManager
Commands
- /afhelp - Get a list of the commands below
- /afcreate <Name> <Image> - Creates a new image with the specified name
- /afremove <Name> - Removes the specified image
- /aflist - Get a list of already created images
- /afplace - Command to place down multiple item frames for you
- /afpause - pauses a running frame
- /afstop - stops a running frame (same as pause, but resets to first image of the animation)
- /afplay - starts/resumes a stopped/paused frame
Permissions
- animatedframes.create - Permission to create images
- animatedframes.remove - Permission to remove images
- animatedframes.list - Permission to list images
- animatedframes.pause - Permission to pause frames
- animatedframes.stop - Permission to stop frames
- animatedframes.play - Permission to play frames
Config
Code (YAML):
# Make sure all animations are started at the same time on startup (useful if you usethe same image on multiple frames)
synchronizedStart: false
# Enable this to not start any frames automatically on server start & if you'd like to start them manually instead
doNotStartAutomatically: false
# This is a (slightly hacky) fix for images which Java interpretes as the wrong image type
# You should enable this if you get this error when creating a image: "java.lang.IllegalArgumentException: Unknown image type 0"
fixImageTypes: false
# Maximum distance for frames to be animated to players
# Note: Increasing this only has an effect if your server's rendering distance for entities is also increased (i.e. spigot.yml entity-tracking-range)
maxAnimateDistance: 32
# (ms) Default delay for GIFs with missing delay information (Time for each frame to be displayed)
defaultDelay: 50
message:
command:
create:
setup:
first: "&ePlease right-click the &abottom-left corner &eof the frame"
second: "&ePlease right-click the &atop-right corner &eof the frame"
set:
first: "&aFirst corner set"
second: "&aSecond corner set"
complete: "&aSetup complete! &eCreating frame '%s' with image '%s'..."
loading: "&7Loading image & generating maps..."
saving: "&7Saving frame data to file..."
starting: "&7Starting playback... (This might take a while - See console for progress)"
started: "&aAnimation started!"
error:
exists: "&cFrame already exists"
invalidImage: "&cInvalid image path specified"
unknownType: "&cCould not identify the image type. Please make sure you are using the correct link. (Generating anyway, check console for errors)"
delete:
stopping: "&eStopping animation..."
removed: "&aFrame removed."
error:
notFound: "&cFrame not found"
start:
starting: "&eStarting animation..."
error:
notFound: "&cFrame not found"
playing: "&cFrame is already playing"
stop:
stopping: "&Stopping animation..."
error:
notFound: "&cFrame not found"
notPlaying: "&cFrame is not playing"
pause:
pausing: "&ePausing animation..."
error:
notFound: "&cFrame not found"
notPlaying: "&cFrame is not playing"
next:
success: "&eSkipped to next frame"
error:
notFound: "&cFrame not found"
notPause: "&cFrame is not paused"
previous:
success: "&eSkipped to previous frame"
error:
notFound: "&cFrame not found"
notPause: "&cFrame is not paused"
click:
setup:
first: "&ePlease right-click the &abottom-left corner &eof the frame"
second: "&ePlease right-click the &atop-right corner &eof the frame"
set:
first: "&aFirst corner set"
second: "&aSecond corner set"
complete: "&aAdded click event %s"
remove: "&ePlease click inside the action you want to remove"
removed: "&eAction removed"
error:
notFound: "&cFrame not found"
place:
first: "&ePlease right-click the &abottom-left&e block"
second: "&ePlease right-click the &atop-right&e block"
set:
first: "&aFirst corner set"
second: "&aSecond corner set"
done: "&aFrames placed!"
error:
face: "&cFirst clicked side does not match the second side"
Tutorials
ServerMiner
Note: The tutorials below use commands from an older version. Please use the similar commands listed above.
(German)
How to create a screen
- Place down blocks to hold your item frames
- Place down the item frames you want to use for the image
- Upload an animation or image (.GIF | .PNG) or find one online. It should be rectangular or it will be stretched. Note: Due to a bug in some Java versions, JPEG images might not look like the original image
- For local image files, just specify the full file path (e.g. C:\\Users\\Me\\myImage.png)
- Run the create command above with a custom name and the url to the image. You can also specify the path to a local file.
- Use shorteners like bitly if the link to your image is too long.
- Follow the instructions you get in the chat:
- Right click the bottom-left item frame and wait
- Right click the top-right item frame and wait for your image to load
Note: For GIPHY images, replace the 'media.giphy.com' domain with 'i.giphy.com'
How to remove a screen
To remove a screen, run the remove command and specify the name
How it works - No lags
This plugin does not cause the expected lag/framerate issues you would expect.
It doesn't update the picture every frame (doing that would cause a lot of frame rate issues), it only updates the map item contained in the item frame.
The actual frames of the animation are only sent once with a little delay to prevent any lag issues.
Links
Please leave a rating if you like this resource.
Donations to support me or this resource are also very much appreciated.
AnimatedFrames 4.13.1-SNAPSHOT
Animated images on item frames!
-
tenderpork, devBowman, Ansandr and 44 others like this.
![[IMG]](http://proxy.spigotmc.org/bddacd54d652acb9f384fe7351d0aea73cce0a17?url=https%3A%2F%2Fi.imgur.com%2FqNp23Zx.jpg)
Recent Updates
- Compatibility May 28, 2021
- fixes Feb 12, 2021
- 1.16.4 support Nov 15, 2020
