All Projects → chunky-dev → Chunky

chunky-dev / Chunky

Licence: gpl-3.0
Minecraft world rendering tool

Programming Languages

java
68154 projects - #9 most used programming language

Projects that are alternatives of or similar to Chunky

Liquidbounce
A free mixin-based injection hacked client for Minecraft using Minecraft Forge
Stars: ✭ 321 (-15.53%)
Mutual labels:  minecraft
Mcpelauncher Manifest
The main repository for the Linux and Mac OS Bedrock edition Minecraft launcher.
Stars: ✭ 338 (-11.05%)
Mutual labels:  minecraft
Phantom
Use your own Minecraft server with your Xbox or PS4 and play with friends!
Stars: ✭ 360 (-5.26%)
Mutual labels:  minecraft
C Ray
C-Ray is a small, simple path tracer written in C
Stars: ✭ 323 (-15%)
Mutual labels:  path-tracer
Hello Vue Django
vuejs and Django integration with hot code reload. Dont use this, use https://github.com/NdagiStanley/vue-django or https://github.com/gtalarico/django-vue-template
Stars: ✭ 335 (-11.84%)
Mutual labels:  minecraft
Blessing Skin Server
Web application brings your custom skins back in offline Minecraft servers.
Stars: ✭ 344 (-9.47%)
Mutual labels:  minecraft
Flying Squid
Create Minecraft servers with a powerful, stable, and high level JavaScript API.
Stars: ✭ 311 (-18.16%)
Mutual labels:  minecraft
Slimefun4
Slimefun 4 - A unique Spigot/Paper plugin that looks and feels like a modpack. We've been giving you backpacks, jetpacks, reactors and much more since 2013.
Stars: ✭ 369 (-2.89%)
Mutual labels:  minecraft
Cc Tweaked
Just another ComputerCraft fork
Stars: ✭ 331 (-12.89%)
Mutual labels:  minecraft
Mcrcon
Rcon client for Minecraft
Stars: ✭ 350 (-7.89%)
Mutual labels:  minecraft
Minecraft Mod Language Package
A language package for Minecraft Mods.
Stars: ✭ 322 (-15.26%)
Mutual labels:  minecraft
Helioslauncher
☀ Custom launcher for modded minecraft written in Electron and Node.js
Stars: ✭ 333 (-12.37%)
Mutual labels:  minecraft
Mscs
Powerful command-line control for UNIX and Linux powered Minecraft servers
Stars: ✭ 347 (-8.68%)
Mutual labels:  minecraft
Gameservers Docker
A bunch of game servers I use, dockerised
Stars: ✭ 322 (-15.26%)
Mutual labels:  minecraft
Cuberite
A lightweight, fast and extensible game server for Minecraft
Stars: ✭ 3,984 (+948.42%)
Mutual labels:  minecraft
Paper
High performance Spigot fork that aims to fix gameplay and mechanics inconsistencies
Stars: ✭ 5,293 (+1292.89%)
Mutual labels:  minecraft
Nameless
NamelessMC is a free, easy to use & powerful website software for your Minecraft server, which includes a large range of features.
Stars: ✭ 337 (-11.32%)
Mutual labels:  minecraft
Seedcracker
Fast, Automatic In-Game Seed Cracker for Minecraft.
Stars: ✭ 364 (-4.21%)
Mutual labels:  minecraft
Amulet Map Editor
A new Minecraft world editor and converter that supports all versions since Java 1.12 and Bedrock 1.7.
Stars: ✭ 356 (-6.32%)
Mutual labels:  minecraft
Replaymod
Minecraft ReplayMod
Stars: ✭ 348 (-8.42%)
Mutual labels:  minecraft

Chunky logo

Chunky

Chunky is a Minecraft rendering tool that uses Path Tracing to create realistic images of your Minecraft worlds.

Discord server · Documentation · Troubleshooting · Subreddit

Quick start guide

Prerequisites: Chunky requires Java 8. It is recommended to have the 64-bit version if you have a 64-bit operating system (you most likely do). If you haven't installed Java, you can download it from here.

  1. Download the Chunky Launcher and open it
  2. Install the latest version of Chunky by clicking on Check for Updates
  3. Click on Launch Chunky start rendering your beautiful buildings

If you have any questions, please don't hesitate to reach out via Reddit, Discord or GitHub.

Frequently Asked Questions

Why is there noise/grain/random bright dots in the render?

This is not a bug, but an unfortunate effect of the rendering algorithm used in Chunky. Torches and other small light sources cause a very random illumination and it takes a long time to render such light nicely.

You can disable emitters under the Lighting tab in the Render Controls dialog to remove most of the random bright dots. Note that rendering for a longer time will eventually remove the noise, though it may take a very long time.

Another way of removing the noise is using the Denoiser Plugin. While this can yield good results in most cases, it may distort the image in some cases.

How long does it take to render an image?

This depends on your CPU, the size of the image and the lighting conditions of the scene you are rendering. You can use the tips from the previous answer to get away with shorter render times.

Why do I see blue question marks or red crosses instead of blocks?

Chunky renders blue question marks for unsupported blocks. Maybe your Chunky version is outdated or the block is not yet supported. If the latter is the case, please file a bug report.

Red crosses are caused by missing textures. Please ensure that you're using a texturepack for the Minecraft version for the world you are rendering.

Why can I only open 1.12 worlds but not 1.13+ worlds (or vice versa)?

Minecraft 1.13 introduced a new world format that is incompatible with the old format. Chunky 2 is only compatible with the new world format and Chunky 1 is only compatible with the old world format.

We have plans to improve this one day. For now, you'll need to use the appropriate Chunky version for your Minecraft version.

Is GPU rendering supported?

GPU support is not actively being worked on right now. If you'd like to tackle this, PRs are welcome!

Why are mobs not rendered?

Chunky currently can't render all entities. Future support for rendering more entities is planned, so stay tuned!

Can Chunky render mod blocks?

No. Due to the vast number of mods, this is not feasible at the moment.

Where can I find good skymaps?

The skymaps page has some good links. Another good place is the #skymaps channel on our Discord server.

Chunky keeps freezing or crashing

Chunky uses a lot of memory. If Chunky has too little memory to work with it may slow down to a crawl or crash. The memory limit can be increased in the Chunky Launcher.

Rendering using the command line (Headless Mode)

It is possible to render a scene from the command line. First set up a scene using the GUI. Don't forget to save the scene. Then run the following on the command line:

java -jar chunky.jar -render SceneName

Where SceneName is the name of the scene to render. You can read more about headless rendering here.

Shutdown when render completes on Unix-like Systems (Mac OS X, Linux, BSD)

In the Advanced tab of the Render Controls window, you can check the checkbox that says "Shutdown when render completes" to shut down your computer when the set SPP target is reached. (This can be toggled while rendering.)

On Unix-like systems, the shutdown terminal command has to be run as root using sudo. For various reasons, Chunky cannot prompt for the password to sudo, so you must configure your system to allow the command to run without a password.

Open a terminal (such as bash) and run sudo visudo, providing your password.

Add the following line at the end of the file: (press Insert to type)

%user_name ALL=(ALL) NOPASSWD: /sbin/shutdown

Replace user_name with your username.

Press Escape, then type :wq.

You may need to restart or log out and in for this to take effect.

This will only allow sudo shutdown to run without a password; no other commands run with sudo will be affected.

What about the Chunky SpigotMC plugin?

The Chunky SpigotMC plugin is an unfortunate name collision and is unrelated to this project. Chunky (SpigotMC plugin) is a handy plugin to quickly pre-generate server chunks should you need that functionality. You can also find Chunky (SpigotMC Plugin) on GitHub.

More information about Chunky, including a short getting started guide and rendering tips are available at the Chunky Documentation page. For more insights into Chunky's development, see the development blog.

Hacking on Chunky

To build Chunky, run the gradlew script in the project root directory: ./gradlew jar

This just builds the core libraries. Building an installable file takes a bit more work; refer to this repository.

Chunky is split into four subprojects:

  • chunky - the core rendering and GUI project
  • lib - common code required by the other projects
  • launcher - the launcher
  • releasetools - tool used for packaging releases

If you want to hack on Chunky itself you will need to load the chunky and lib directories in your favorite editor. If available, use a Gradle project import option.

Code Style

The Google Java style guide should be followed for new code (2 spaces for indentation, no tabs). If you want to contribute code to Chunky please make your code look similar to the rest of the code, and refer to the style guide when in doubt.

Copyright & License

Chunky is Copyright (c) 2010-2021, Jesper Öqvist [email protected] and Chunky Contributors.

Permission to modify and redistribute is granted under the terms of the GPLv3 license. See the file LICENSE for the full license.

Chunky uses the following 3rd party libraries:

  • Markdown by John Gruber. Markdown is covered by the Modified BSD License. See the file licenses/Markdown.txt for the full license and copyright notice.
  • Apache Commons Math library by the Apache Software Foundation. The library is covered by the Apache License, version 2.0. See the file licenses/Apache-2.0.txt for the full license text. See the file licenses/commons-math.txt for the copyright notices.
  • FastUtil by Sebastiano Vigna. FastUtil is covered by Apache License, version 2.0. See the file licenses/Apache-2.0.txt for the full license text. See the file licenses/fast-util.txt for the copyright notice.
Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].