{
  "$type": "site.standard.document",
  "bskyPostRef": {
    "cid": "bafyreialw4uewqvhf45fkk4wcplkljqgbstk6hhks2ttq2gzti36qm3b2q",
    "uri": "at://did:plc:25rdn5elo5izoxrmtis34zuk/app.bsky.feed.post/3mpj5uk75ibf2"
  },
  "coverImage": {
    "$type": "blob",
    "ref": {
      "$link": "bafkreidbajbc7vmqia32ivkxxprzilu2uuqxtvq6rgvasehzged2eczlry"
    },
    "mimeType": "image/webp",
    "size": 92264
  },
  "path": "/codenameone/the-codename-one-game-builder-draw-the-level-code-the-rules-19gl",
  "publishedAt": "2026-06-30T13:35:15.000Z",
  "site": "https://dev.to",
  "tags": [
    "java",
    "mobile",
    "android",
    "ios",
    "Friday's release post",
    "codenameone.com",
    "PR #5253",
    "issue tracker",
    "@Override"
  ],
  "textContent": "Friday's release post introduced the Game Builder and promised a tutorial series. This post is the orientation that sits in front of those tutorials: what the Game Builder is, how its pieces fit together, and why it exists. The hands-on builds start Thursday.\n\n**What is Codename One?** Codename One is an open-source framework for building native iOS, Android, desktop, and web apps from a single Java or Kotlin codebase. Learn more at codenameone.com.\n\nLast week we shipped the `com.codename1.gaming` API: a game loop, sprites, scenes, pollable input, a low-latency sound pool, and Box2D physics, all running unchanged on every platform including iOS. That gave you the runtime. The missing half was authoring. Building a level purely in Java means dozens of `new Sprite(...)`, `setX`, and `setY` calls you cannot see until you run them and must recompile to tweak. The Game Builder (PR #5253) replaces that with a visual editor and a plain-data level file.\n\n##  Draw the level, code only the rules\n\nThe core idea is that a level is data, not code. You draw it in the editor, tag each object with the numbers your game needs (`lives`, `value`, `speed`), and the editor saves a small `.game` file. The runtime loads that file and realizes it into a scene of sprites. What is left for you to write is the part that is actually yours: the rules.\n\nThe editor is itself a Codename One app (Java 17) with three panels that matter: the **Hierarchy** of layers and objects, the **Asset Library** of art you stamp down, and the **Inspector** for the selected object's transform and behavior values. Two Maven goals drive it:\n\n\n\n    mvn cn1:create-game-scene -DclassName=com.example.mygame.MyScene\n    mvn cn1:gamebuilder\n\n\n`create-game-scene` writes an empty `.game` level and a companion Java class into your project; `cn1:gamebuilder` opens the editor on it. Both goals are gated to Java 17.\n\n##  One editor, three kinds of game\n\nThe same editor and the same `.game` format author three modes, and the runtime realizes each one without your code changing shape:\n\n  * **2D** , for side-scrollers and top-down games. A tile grid, layers for draw order, and sprites.\n  * **Board** , an isometric projection for card and tabletop games, where pieces are data-driven elements on a board.\n  * **3D** , for first-person and overhead 3D, with terrain you sculpt and a per-game-type preview (open, flight, race, or dungeon) complete with a radar.\n\n\n\nThe three tutorials each build one of these, so the range is easiest to see as three finished games:\n\n\n\n\n\nThe 3D editor sculpts terrain directly: height, holes, walls, pluggable surface materials, and smooth interpolated slopes, all previewed in the form factor of the game you are making.\n\n##  From `.game` file to running game\n\nThe data model lives in `com.codename1.gaming.level`: `GameLevel`, `GameElement`, `Layer`, `TileLayer`, `AssetCatalog`, and `IsoProjection`, with JSON load and save across all three modes. Your companion class loads the level and the editor regenerates the wiring for every object you named, so renaming or adding an object in the Inspector just updates your fields. The constructor and the update loop are yours:\n\n\n\n    public class MyScene extends GameSceneView {\n        public MyScene(AssetCatalog catalog) {\n            super(loadLevel(), catalog);   // realizes the level into a Scene of Sprites\n            setArcadeBehavior(true);       // built-in run/jump/gravity/patrol/pickups (2D)\n        }\n\n        private static GameLevel loadLevel() throws java.io.IOException {\n            return GameLevel.load(Display.getInstance()\n                    .getResourceAsStream(MyScene.class, \"/MyScene.game\"));\n        }\n\n        @Override\n        protected void onUpdate(double deltaSeconds) {\n            // your rules go here\n        }\n    }\n\n\n`GameSceneView` is a `GameView`, which is a regular Codename One `Component`, so you drop it into a `Form` and call `start()` to begin the loop. Because you edit `onUpdate` and not the generated block, re-running `cn1:gamebuilder` to tweak the level keeps your logic intact.\n\n##  Large worlds that stream\n\nSome games outgrow a single hand-drawn level. The Game Builder ships a streaming engine for large and open worlds, and the editor has a **Large World** mode that edits and previews the active region. The pieces are a pluggable `Material` and `MaterialRegistry`; a chunked `StreamingTerrain` with a `ChunkProvider`, LRU paging, and support for negative coordinates; variable-size `TerrainFeature` objects for walls, ramps, and platforms; and loadable `Region` and `RegionProvider` types stitched into a `GameWorld` that streams neighboring regions in seamlessly. A `GameLevel` can persist an optional `GameWorld`, so a streaming world saves and loads like any other level.\n\n##  A note on beta\n\nThe Game Builder and the high-level gaming APIs are **beta**. They work, the tutorials are real games you can build start to finish, and they run on every platform. What is not yet settled is the shape: the editor's interactions, the API surface, and the asset workflow are all things we expect to refine. That is exactly why we are shipping it now and writing about it: we want your reports. If the editor fights you, an API reads wrong, or an asset will not import the way you expect, file it on the issue tracker with the project or asset attached.\n\n##  Where to go next\n\nThe three tutorials build a real game each, in increasing order of ambition:\n\n  * **Thursday.** . It covers the part most tutorials skip: bringing in real art and slicing an animated sprite sheet.\n  * **The Thursday after.** . Cards become data-driven elements on a felt table.\n  * **The Thursday after that.** . Sculpt terrain and scale up to streaming worlds.\n\n\n\nStart with Thursday's platformer; it introduces every moving part you will reuse in the other two.",
  "title": "The Codename One Game Builder: Draw The Level, Code The Rules"
}