Single Texture Atlas Material

Oct 13, 2025 by wbrum.org 88 views

Introduction

The HYTOPIA team is excited to announce an official feature bounty aimed at optimizing block rendering in the game client. This feature bounty seeks to replace the existing block rendering implementation with a more performant approach, utilizing a single texture atlas material, buffer geometry meshes, and batched chunk loading. The goal is to significantly improve rendering performance for larger maps, making the game more enjoyable for players.

Bounty Details

A feature bounty of $1,250 USD will be awarded via PayPal or USDC to the creator of the pull request that successfully satisfies the requirements of this feature bounty, after approval by the HYTOPIA team. This bounty is an excellent opportunity for developers to showcase their skills and contribute to the improvement of the HYTOPIA game client.

Required Functionality

To be eligible for the bounty, the submitted pull request must meet the following requirements:

Single Texture Atlas Material

The implementation should use a single ThreeJS Material that points to a texture atlas as a canvas that includes all textures.
This optimization reduces draw calls on the GPU, increasing performance.
The texture atlas must correctly handle import & removal of custom block textures, and appropriately update UV coordinates.

Buffer Geometry Meshes

The mesh representation of blocks should use an implementation as performant as Buffer Geometries.
This approach provides a more efficient way to render complex geometries.

Batched Chunk Loading

Chunks when a map is loading should load in batches per animation frame.
Depending on the implementation, it's recommended to load 2 to 3 chunks per animation frame for optimal performance.

Examples & Resources

To help developers get started, we've included reference files as a gist from the existing HYTOPIA game client. These files demonstrate implementations for single material texture atlas using canvas, meshes using buffer geometries, and batched chunk loading. You can use these examples as inspiration to reimplement the same approach into the editor codebase.

https://gist.github.com/iamarkdev/460a3574fbe79f7116158806e2c03278

Clarifications & Conditions

Before submitting your pull request, please note the following:

The HYTOPIA team reserves the right to make the final decision as to what PR is accepted and awarded the bounty.
After submitting your PR, we reserve the right to request reasonable changes, bug fixes, code quality, and performance changes prior to your PR being accepted and awarded the bounty.
We will make a point to give quick feedback on questions related to this bug bounty request. Leave your questions or comments as replies to this issue. You may also @ us with questions or requests for review or comment in your PR once submitted.
If you have questions, you can DM me directly on Discord: @iamarkdev
Join our Discord community if you haven't! https://discord.gg/hytopia

Getting Started

If you're interested in participating in this feature bounty, please follow these steps:

Review the required functionality and examples provided.
Familiarize yourself with the HYTOPIA game client codebase.
Submit your pull request with a clear and concise description of the changes made.
Engage with the HYTOPIA team through comments and discussions to ensure your implementation meets the requirements.

We look forward to seeing your contributions and working together to improve the HYTOPIA game client.

Timeline

The timeline for this feature bounty is as follows:

Submission Deadline: [Insert Date]
Evaluation Period: [Insert Date]
Award Announcement: [Insert Date]

Evaluation Criteria

The HYTOPIA team will evaluate submissions based on the following criteria:

Correctness: Does the implementation meet the required functionality?
Performance: Does the implementation provide a significant performance improvement?
Code Quality: Is the code well-structured, readable, and maintainable?
Adherence to Guidelines: Does the implementation follow the HYTOPIA game client code guidelines?

Conclusion

Introduction

The HYTOPIA team is excited to announce an official feature bounty aimed at optimizing block rendering in the game client. This feature bounty seeks to replace the existing block rendering implementation with a more performant approach, utilizing a single texture atlas material, buffer geometry meshes, and batched chunk loading. To help developers better understand the requirements and implementation details, we've put together a Q&A article.

Q: What is the goal of this feature bounty?

A: The goal of this feature bounty is to significantly improve rendering performance for larger maps by replacing the existing block rendering implementation with a more performant approach, utilizing a single texture atlas material, buffer geometry meshes, and batched chunk loading.

Q: What is a single texture atlas material?

A: A single texture atlas material is a ThreeJS Material that points to a texture atlas as a canvas that includes all textures. This optimization reduces draw calls on the GPU, increasing performance.

Q: How does the texture atlas handle import & removal of custom block textures?

A: The texture atlas must correctly handle import & removal of custom block textures, and appropriately update UV coordinates. This ensures that the texture atlas remains up-to-date and accurate.

Q: What is buffer geometry, and why is it used?

A: Buffer geometry is a performant way to render complex geometries. It's used in this feature bounty to provide a more efficient way to render block meshes.

Q: How does batched chunk loading work?

A: Chunks when a map is loading should load in batches per animation frame. Depending on the implementation, it's recommended to load 2 to 3 chunks per animation frame for optimal performance.

Q: What is the timeline for this feature bounty?

A: The timeline for this feature bounty is as follows:

Submission Deadline: [Insert Date]
Evaluation Period: [Insert Date]
Award Announcement: [Insert Date]

Q: How will submissions be evaluated?

A: The HYTOPIA team will evaluate submissions based on the following criteria:

Correctness: Does the implementation meet the required functionality?
Performance: Does the implementation provide a significant performance improvement?
Code Quality: Is the code well-structured, readable, and maintainable?
Adherence to Guidelines: Does the implementation follow the HYTOPIA game client code guidelines?

Q: Can I ask questions or request feedback during the evaluation period?

A: Yes, you can ask questions or request feedback during the evaluation period. Please leave your questions or comments as replies to this issue. You may also @ us with questions or requests for review or comment in your PR once submitted.

Q: How can I get started with this feature bounty?

A: To get started with this feature bounty, please follow these steps:

Review the required functionality and examples provided.
Familiarize yourself with the HYTOPIA game client codebase.
Submit your pull request with a clear and concise description of the changes made.
Engage with the HYTOPIA team through comments and discussions to ensure your implementation meets the requirements.

Conclusion

The HYTOPIA team is excited to offer this feature bounty and looks forward to seeing the innovative solutions that developers will bring to the table. By optimizing block rendering using a single texture atlas material, buffer geometry meshes, and batched chunk loading, we can significantly improve the performance of the game client and provide a better experience for players.

Additional Resources

HYTOPIA Game Client Codebase: Familiarize yourself with the HYTOPIA game client codebase to better understand the implementation details.
ThreeJS Documentation: Review the ThreeJS documentation to learn more about single texture atlas materials and buffer geometry.
HYTOPIA Discord Community: Join the HYTOPIA Discord community to ask questions, request feedback, and engage with the HYTOPIA team.

Submission Guidelines

Submission Deadline: [Insert Date]
Evaluation Period: [Insert Date]
Award Announcement: [Insert Date]

Evaluation Criteria

Correctness: Does the implementation meet the required functionality?
Performance: Does the implementation provide a significant performance improvement?
Code Quality: Is the code well-structured, readable, and maintainable?
Adherence to Guidelines: Does the implementation follow the HYTOPIA game client code guidelines?