Implement Hytale template by EduardoMRS · Pull Request #352 · pufferpanel/templates

EduardoMRS · 2026-01-27T17:50:12Z

Hey guys, this is the first model I developed for Pufferpanel, so I believe it might have some issues. I based this one on models like minecraft-java and minecraft-bedrock, following the same logic for using Java and manipulating compressed files. During installation, user interaction is required to authenticate with Hytale and continue the process, but I don't think this will be a problem; the necessary information is displayed in the console.

LadyHaley · 2026-01-27T20:14:57Z

I went to give this a spin myself, it wont progress past the install stage for me, but it is the furthest a hytale installer has gotten on v3 for me so far

Installing server
Downloading Java 25
Creating directory: Download
Creating directory: Server
Downloading file https://downloader.hytale.com/hytale-downloader.zip
Executing: mv ./hytale-downloader.zip ./Download/hytale-downloader.zip
Starting container
Executing: rm -rf ./Download/hytale-downloader.zip
Starting container
Executing: rm -rf .zip
Starting container
Executing: chmod +x ./Download/hytale-downloader-linux-amd64
Starting container
Executing: ./Download/hytale-downloader-linux-amd64
Starting container
downloading latest ("release" patchline) to "2026.01.27-734d39026.zip"
[==================================================] 100.0% (1.4 GB / 1.4 GB)B)
validating checksum...
successfully downloaded "release" patchline (version 2026.01.27-734d39026)
Executing: find . -type f -name '.zip' -exec sh -c 'mv "$1" "update.zip"' sh {} ;
Starting container
Failed to install server

A notification comes up saying directory update.zip doesnt exsist

EduardoMRS · 2026-01-28T03:24:25Z

I went to give this a spin myself, it wont progress past the install stage for me, but it is the furthest a hytale installer has gotten on v3 for me so far

Thanks for the comment. Just to confirm, you're using Puffer in Docker? I believe I made a mistake in the zip verification execution for processing I hadn't realized that Docker is a bit different, but I'll correct it now.

LadyHaley · 2026-01-28T07:45:49Z

I went to give this a spin myself, it wont progress past the install stage for me, but it is the furthest a hytale installer has gotten on v3 for me so far

Thanks for the comment. Just to confirm, you're using Puffer in Docker? I believe I made a mistake in the zip verification execution for processing I hadn't realized that Docker is a bit different, but I'll correct it now.

Yeah thats right, I am using puffer panel v3 and my container is in docker

EduardoMRS · 2026-01-28T15:44:22Z

Yeah thats right, I am using puffer panel v3 and my container is in docker

I made a correction to the installation logic for execution in Docker. If possible, test it now.

monokin · 2026-01-29T00:44:19Z

Does this work in puffer v2? Or just v3

EduardoMRS · 2026-01-29T01:21:16Z

Does this work in puffer v2? Or just v3

The model was created using v3 as a base, but tested locally with v2 it worked without problems.

monokin · 2026-01-29T01:26:05Z

Does this work in puffer v2? Or just v3

The model was created using v3 as a base, but tested locally with v2 it worked without problems.

Hmm I have a unknown issue trying to actually make the server. I can get the template in but creating the sever does not work. I am going to update to v3.

monokin · 2026-01-29T03:56:22Z

Does this work in puffer v2? Or just v3

The model was created using v3 as a base, but tested locally with v2 it worked without problems.

Hmm I have a unknown issue trying to actually make the server. I can get the template in but creating the sever does not work. I am going to update to v3.

Well it wasnt working cause I didnt set gamemode. Thanks! Haha

LadyHaley · 2026-01-29T11:42:51Z

I made a correction to the installation logic for execution in Docker. If possible, test it now.

It now works for me!!! Thanks so much!!!

EduardoMRS · 2026-01-29T13:02:36Z

Does this work in puffer v2? Or just v3

The model was created using v3 as a base, but tested locally with v2 it worked without problems.

Hmm I have a unknown issue trying to actually make the server. I can get the template in but creating the sever does not work. I am going to update to v3.

Well it wasnt working cause I didnt set gamemode. Thanks! Haha

Great, I added default values to the initial configuration entry to avoid problems if something in the server isn't configured this probably won't happen forget again, haha.

EduardoMRS · 2026-01-29T13:07:20Z

I made a correction to the installation logic for execution in Docker. If possible, test it now.

It now works for me!!! Thanks so much!!!

Great, I'm so glad it's working now! 😄

Blueeyestar · 2026-01-29T15:18:44Z

Why is the server throwing so many errors? Is it because of the early access version? Are you also seeing this in the Pufferpanel console?

[2026/01/29 15:36:20 SEVERE] [ChunkStore] Took too long to pre-load process chunk: 39ms 907us 884ns > TICK_STEP, Has GC Run: true, WorldChunk{x=33, z=24, flags=00000000000000000000000000000100} [2026/01/29 15:36:20 SEVERE] [ChunkStore] Took too long to pre-load process chunk: 42ms 546us 152ns > TICK_STEP, Has GC Run: false, WorldChunk{x=20, z=37, flags=00000000000000000000000000000100} [2026/01/29 15:36:20 SEVERE] [World|default] Took too long to run pre-load process hook for chunk: 93ms 49us 379ns > TICK_STEP, WorldChunk{x=33, z=23, flags=00000000000000000000000000000100}, Hook: com.hypixel.hytale.builtin.fluid.FluidPlugin$$Lambda/0x00007f0584a74da0@384cd83a [2026/01/29 15:36:20 SEVERE] [World|default] Took too long to run pre-load process hook for chunk: 34ms 223us 95ns > TICK_STEP, WorldChunk{x=33, z=-8, flags=00000000000000000000000000000100}, Hook: com.hypixel.hytale.server.core.modules.block.BlockModule$$Lambda/0x00007f05849bb200@49c37918 [2026/01/29 15:36:20 SEVERE] [World|default] Took too long to run pre-load process hook for chunk: 34ms 822us 656ns > TICK_STEP, WorldChunk{x=34, z=21, flags=00000000000000000000000000000100}, Hook: com.hypixel.hytale.builtin.blocktick.BlockTickPlugin$$Lambda/0x00007f05848ef2f8@70f76276 [2026/01/29 15:36:20 SEVERE] [ChunkStore] Took too long to pre-load process chunk: 33ms 472us 160ns > TICK_STEP, Has GC Run: false, WorldChunk{x=20, z=-21, flags=00000000000000000000000000000100} [2026/01/29 15:36:21 SEVERE] [ChunkStore] Took too long to pre-load process chunk: 33ms 861us 235ns > TICK_STEP, Has GC Run: false, WorldChunk{x=16, z=39, flags=00000000000000000000000000000100} [2026/01/29 15:36:21 SEVERE] [ChunkStore] Took too long to pre-load process chunk: 42ms 719us 649ns > TICK_STEP, Has GC Run: false, WorldChunk{x=36, z=12, flags=00000000000000000000000000000100} [2026/01/29 15:36:21 SEVERE] [World|default] Took too long to run pre-load process hook for chunk: 71ms 880us 474ns > TICK_STEP, WorldChunk{x=36, z=14, flags=00000000000000000000000000000100}, Hook: com.hypixel.hytale.builtin.fluid.FluidPlugin$$Lambda/0x00007f0584a74da0@384cd83a [2026/01/29 15:36:21 SEVERE] [World|default] Took too long to run pre-load process hook for chunk: 104ms 867us 573ns > TICK_STEP, WorldChunk{x=36, z=16, flags=00000000000000000000000000000100}, Hook: com.hypixel.hytale.builtin.fluid.FluidPlugin$$Lambda/0x00007f0584a74da0@384cd83a

EduardoMRS · 2026-01-29T16:34:35Z

Why is the server throwing so many errors? Is it because of the early access version? Are you also seeing this in the Pufferpanel console?

`[2026/01/29 15:36:20 SEVERE] [ChunkStore] Took too long to pre-load process chunk: 39ms 907us 884ns > TICK_STEP, Has GC Run: true, WorldChunk{x=33, z=24, flags=00000000000000000000000000000100} [2026/01/29 15:36:20 SEVERE] [ChunkStore] Took too long to pre-load process chunk: 42ms 546us 152ns > TICK_STEP, Has GC Run: false,

Yes, this is expected with the current Early Access server.

These logs are performance warnings from the world/chunk preloading system when a chunk takes longer than the target tick time. They happen both inside and outside PufferPanel and don’t indicate a configuration or template issue.

I’m seeing the same messages locally as well, and they don’t seem to impact gameplay or server stability. It’s likely due to the engine still being optimized in this Early Access phase.

monokin · 2026-02-03T19:01:26Z

Would it be possible to make the amount of kept backups a configurable option in the server settings by chance?

EduardoMRS · 2026-02-03T20:07:50Z

Would it be possible to make the amount of kept backups a configurable option in the server settings by chance?

Looking the documentation, I didn't find an option to set a backup limit. Perhaps it's possible to do this by clearing the folder after a certain limit is reached in the configuration. I'll check again and try to implement something along those lines.

Da-Sz · 2026-02-14T23:24:19Z

Hi @EduardoMRS, when using docker environment, the installation fails (default config)

opening zip reader: open /var/lib/pufferpanel/servers/cf87476a/Download/hytale-downloader.zip: no such file or directory

Logs:

Installing server
Downloading Java 25
Creating directory: Download
Creating directory: Server
Creating directory: Server/universe/worlds/default/
Downloading file https://downloader.hytale.com/hytale-downloader.zip
Failed to install server

EduardoMRS · 2026-02-16T12:27:47Z

Hi @EduardoMRS, when using docker environment, the installation fails (default config)

opening zip reader: open /var/lib/pufferpanel/servers/cf87476a/Download/hytale-downloader.zip: no such file or directory

Logs:

Installing server Downloading Java 25 Creating directory: Download Creating directory: Server Creating directory: Server/universe/worlds/default/ Downloading file https://downloader.hytale.com/hytale-downloader.zip Failed to install server

Thank you for your comment. The problem was simply a blank space in the folder path; I just uploaded a fix.

hytale/hytale.json

Da-Sz · 2026-02-21T17:09:07Z

Hi @EduardoMRS, when using docker environment, the installation fails (default config)
opening zip reader: open /var/lib/pufferpanel/servers/cf87476a/Download/hytale-downloader.zip: no such file or directory
Logs:
Installing server Downloading Java 25 Creating directory: Download Creating directory: Server Creating directory: Server/universe/worlds/default/ Downloading file https://downloader.hytale.com/hytale-downloader.zip Failed to install server

Thank you for your comment. The problem was simply a blank space in the folder path; I just uploaded a fix.

Hi @EduardoMRS, thank you for your update 😄
However, after retrying with your new changes, the server still fails to start.

Could you try to test your json again on your side from installation to running the server ?

Here are the latest logs:

downloading latest ("release" patchline) to "2026.02.19-1a311a592.zip"
[==================================================] 100.0% (1.4 GB / 1.4 GB)B)
validating checksum...
successfully downloaded "release" patchline (version 2026.02.19-1a311a592)
Executing: sh -c "ZIP=\$(find . -type f -name '*.zip' | head -n 1) && [ -n \"\$ZIP\" ] && mv \"\$ZIP\" update.zip"
Starting container
Writing some data to file: ./Server/config.json
Writing some data to file: ./Server/universe/worlds/default/config.json
Server installed
Starting server
Executing: bash -c "if [ -f updater/staging/Server/HytaleServer.jar ]; then echo '[Launcher] Applying staged update...'; cp -f updater/staging/Server/HytaleServer.jar Server/; [ -f updater/staging/Server/HytaleServer.aot ] && cp -f updater/staging/Server/HytaleServer.aot Server/; [ -d updater/staging/Server/Licenses ] && rm -rf Server/Licenses && cp -r updater/staging/Server/Licenses Server/; [ -f updater/staging/Assets.zip ] && cp -f updater/staging/Assets.zip ./; [ -f updater/staging/start.sh ] && cp -f updater/staging/start.sh ./; [ -f updater/staging/start.bat ] && cp -f updater/staging/start.bat ./; rm -rf updater/staging; fi"
Starting container
Executing: bash -c "BACKUP_DIR=\"../backup/\"; MAX_BACKUPS=5; if [ -d \"\$BACKUP_DIR\" ] && [ \$MAX_BACKUPS -gt 0 ]; then TOTAL=\$(ls -1t \"\$BACKUP_DIR\" 2>/dev/null | wc -l); if [ \$TOTAL -gt \$MAX_BACKUPS ]; then ls -1t \"\$BACKUP_DIR\" | tail -n +\$((MAX_BACKUPS + 1)) | while read f; do rm -rf \"\$BACKUP_DIR/\$f\"; done; echo \"[Backup] Cleaned old backups, kept \$MAX_BACKUPS most recent.\"; fi; fi"
Starting container
Starting container
Server: -c: line 1: unexpected EOF while looking for matching `''
Running post-execution steps

EduardoMRS · 2026-02-21T17:12:45Z

Hi @EduardoMRS, when using docker environment, the installation fails (default config)

opening zip reader: open /var/lib/pufferpanel/servers/cf87476a/Download/hytale-downloader.zip: no such file or directory

Logs:

Installing server Downloading Java 25 Creating directory: Download Creating directory: Server Creating directory: Server/universe/worlds/default/ Downloading file https://downloader.hytale.com/hytale-downloader.zip Failed to install server

Thank you for your comment. The problem was simply a blank space in the folder path; I just uploaded a fix.

Hi @EduardoMRS, thank you for your update 😄

However, after retrying with your new changes, the server still fails to start.

Could you try to test your json again on your side from installation to running the server ?

Here are the latest logs:
downloading latest ("release" patchline) to "2026.02.19-1a311a592.zip"

[==================================================] 100.0% (1.4 GB / 1.4 GB)B)

validating checksum...

successfully downloaded "release" patchline (version 2026.02.19-1a311a592)

Executing: sh -c "ZIP=\$(find . -type f -name '*.zip' | head -n 1) && [ -n \"\$ZIP\" ] && mv \"\$ZIP\" update.zip"

Starting container

Writing some data to file: ./Server/config.json

Writing some data to file: ./Server/universe/worlds/default/config.json

Server installed

Starting server

Executing: bash -c "if [ -f updater/staging/Server/HytaleServer.jar ]; then echo '[Launcher] Applying staged update...'; cp -f updater/staging/Server/HytaleServer.jar Server/; [ -f updater/staging/Server/HytaleServer.aot ] && cp -f updater/staging/Server/HytaleServer.aot Server/; [ -d updater/staging/Server/Licenses ] && rm -rf Server/Licenses && cp -r updater/staging/Server/Licenses Server/; [ -f updater/staging/Assets.zip ] && cp -f updater/staging/Assets.zip ./; [ -f updater/staging/start.sh ] && cp -f updater/staging/start.sh ./; [ -f updater/staging/start.bat ] && cp -f updater/staging/start.bat ./; rm -rf updater/staging; fi"

Starting container

Executing: bash -c "BACKUP_DIR=\"../backup/\"; MAX_BACKUPS=5; if [ -d \"\$BACKUP_DIR\" ] && [ \$MAX_BACKUPS -gt 0 ]; then TOTAL=\$(ls -1t \"\$BACKUP_DIR\" 2>/dev/null | wc -l); if [ \$TOTAL -gt \$MAX_BACKUPS ]; then ls -1t \"\$BACKUP_DIR\" | tail -n +\$((MAX_BACKUPS + 1)) | while read f; do rm -rf \"\$BACKUP_DIR/\$f\"; done; echo \"[Backup] Cleaned old backups, kept \$MAX_BACKUPS most recent.\"; fi; fi"

Starting container

Starting container

Server: -c: line 1: unexpected EOF while looking for matching `''

Running post-execution steps

I'll take a look at it today and fix the problem soon. Thanks😁

Implement Hytale template

59e6d4e

Fix to run in docker

26581b9

Update README with version available

b315544

Implement gamemode default and other var

ade7d7c

Backup limit implemented.

32057f9

Correcting the extraction of the base file during installation.

b9ddf3d

Hot fix path to folder reference

d0fcce8

LordRalex requested changes Feb 17, 2026

View reviewed changes

hytale/hytale.json Outdated Show resolved Hide resolved

hytale/hytale.json Outdated Show resolved Hide resolved

hytale/hytale.json Outdated Show resolved Hide resolved

hytale/hytale.json Outdated Show resolved Hide resolved

hytale/hytale.json Outdated Show resolved Hide resolved

Implemented the improvement changes suggested by LordRalex.

aed621b

Fix start in docker

25666bb

Conversation

EduardoMRS commented Jan 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

LadyHaley commented Jan 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

EduardoMRS commented Jan 28, 2026

Uh oh!

LadyHaley commented Jan 28, 2026

Uh oh!

EduardoMRS commented Jan 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

monokin commented Jan 29, 2026

Uh oh!

EduardoMRS commented Jan 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

monokin commented Jan 29, 2026

Uh oh!

monokin commented Jan 29, 2026

Uh oh!

LadyHaley commented Jan 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

EduardoMRS commented Jan 29, 2026

Uh oh!

EduardoMRS commented Jan 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Blueeyestar commented Jan 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

EduardoMRS commented Jan 29, 2026

Uh oh!

monokin commented Feb 3, 2026

Uh oh!

EduardoMRS commented Feb 3, 2026

Uh oh!

Da-Sz commented Feb 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

EduardoMRS commented Feb 16, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Da-Sz commented Feb 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

EduardoMRS commented Feb 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

EduardoMRS commented Jan 27, 2026 •

edited

Loading

LadyHaley commented Jan 27, 2026 •

edited

Loading

EduardoMRS commented Jan 28, 2026 •

edited

Loading

EduardoMRS commented Jan 29, 2026 •

edited

Loading

LadyHaley commented Jan 29, 2026 •

edited

Loading

EduardoMRS commented Jan 29, 2026 •

edited

Loading

Blueeyestar commented Jan 29, 2026 •

edited

Loading

Da-Sz commented Feb 14, 2026 •

edited

Loading

Da-Sz commented Feb 21, 2026 •

edited

Loading

EduardoMRS commented Feb 21, 2026 •

edited

Loading