BlueLib - Library for Unity RW blueprints

Hi everyone, this is a small project that I started some weeks ago to help content-makers and myself to make more things for modern Unity Rising World.

This library allows you to manipulate with Rising World blueprints using Java code. The library itself is very simple, but it have full support for Blueprint V6 format including construction elements, objects, plants, screenshots and thumbnails of blueprints.

This library was designed to work with Java 8 and higher. It also depends on LZ4 Java library (compression format of modern blueprints).

Main features:

• BlueprintIO - allows to save and load blueprints from files, streams and buffers;
• Blueprint - class that represent blueprint instance;
• BlueprintElement - construction elements in blueprints;
• BlueprintObject - objects (furniture) in blueprints;
• BlueprintPlant - plants in blueprints;
• LittleEndianDataOutputStream - stream to save data in LittleEndian order.

Constants:

• BlueprintElementType - contains default construction element types (with names from definitions.db);
• BlueprintObjectType - contains default object types (with names from definitions.db);
• BlueprintPlantType - contains default plant types (with names from definitions.db);
• BlueprintVersion - contains blueprint version IDs.

How to add library to your project using Gradle

Releases: GitHub Releases

Sources: GitHub page
License: MIT

Some examples of what you can do using this library:

Known bugs:
- Generated images for blueprints will be not displayed correctly in game. This will not happen with loaded and saved blueprints Fixed since 0.1.1

Thank you

I found why images and icons were not saved correctly - image should have proper color scheme to be saved as JPG. So, I made a small fix for that and published it

Some newer tests - menger sponges. The nearest one has 160000 construction elements, game take some time to place it in a world, but the render and FPS are stable

So, I tried to find game limits, and I have success.

I present you largest menger sponge that you can create in single blueprint. It contains 3200000 construction elements. Sponge of larger size will not fit into blueprint.

I waited approximately 15 minutes until blueprint wil lbe placed in the game. And I get 15-20 FPS after that, so I guess game limit is near 18M polygons of construction elements on the frame (if you will not look on it - FPS will increase up to 50).

This is how this monstrosity looks like (sponge side is 200 units, 5 iterations):

In game it looks much more epic as on screens.

Bonus - me waiting 15 minutes when sponge is building

What about some paintings?

It is possible to load image, turn pixels into elements and then place in the game

Don't stand too close, Ambient occlusion will kill your FPS

private static void makePainting(File input, String name, int resize) throws IOException {
        Blueprint blueprint = Blueprint.create();
        BufferedImage load = ImageIO.read(input);
        BufferedImage img = new BufferedImage(load.getWidth() / resize, load.getHeight() / resize, BufferedImage.TYPE_INT_ARGB);
        img.getGraphics().drawImage(load, 0, 0, img.getWidth(), img.getHeight(), null);
        
        blueprint.creator = "paulevs";
        blueprint.screenshot = img;
        blueprint.thumbnail = img;
        
        blueprint.sizeX = img.getWidth() * 0.01F;
        blueprint.sizeY = img.getHeight() * 0.01F;
        blueprint.name = "Bee painting";
        
        for (int y = 0; y < img.getHeight(); y++) {
            for (int x = 0; x < img.getWidth(); x++) {
                BlueprintElement element = new BlueprintElement(BlueprintElementType.PANE);
                element.texture = 556;
                element.setSize(0.01F, 0.01F, 0.01F);
                element.setPosition(x * 0.01F, (img.getHeight() - y) * 0.01F, 0);
                int color = img.getRGB(x, y);
                element.rgba = color << 8 | 255;
                blueprint.addElement(element);
            }
        }
        
        BlueprintIO.write(blueprint, new File("D:/SteamLibrary/steamapps/common/RisingWorld/_New Version/Blueprints/" + name + ".blueprint"));
    }

BlueLib was updated to support new Rising World Unity 0.6+ version

Changes:

• Added blueprint terrain
• Added all terrain materials
• Added all new plants
• Added all new objects
• Slightly optimised code

Floating islands, since why not

Floating Island.blueprint