diff --git a/docs/SPEC.md b/docs/SPEC.md index 4f282c0..d0b71a2 100644 --- a/docs/SPEC.md +++ b/docs/SPEC.md @@ -1,6 +1,6 @@ -# Carbon Java — Formal Language Specification +# Carbon Lang — Formal Language Specification -This document is the technical reference for the Carbon Java compiler and runtime. It defines every keyword, grammar rule, and behaviour of the language. This is intended for the developers building the compiler and Carbon Lib mod — not for end users. +This document is the technical reference for the Carbon Lang compiler and runtime. It defines every keyword, grammar rule, and behaviour of the language. This is intended for the developers building the compiler and Carbon Lib mod — not for end users. --- @@ -208,7 +208,7 @@ Any attempt to reference these should be caught at compile time and reported as ## 12. Compilation Pipeline (Option B — Transpile to Java) -Carbon Java uses a transpile-then-compile approach. `.cj` files are never directly converted to bytecode. Instead they go through a pipeline: `.cj` → token list → AST → `.java` source → `.class` bytecode → live JVM class. +Carbon Lang uses a transpile-then-compile approach. `.cj` files are never directly converted to bytecode. Instead they go through a pipeline: `.cj` → token list → AST → `.java` source → `.class` bytecode → live JVM class. This makes the compiler easier to build, easier to debug, and produces readable intermediate output at every step. diff --git a/docs/allotrope/allotrope.md b/docs/allotrope/allotrope.md index 8f90113..1f2922d 100644 --- a/docs/allotrope/allotrope.md +++ b/docs/allotrope/allotrope.md @@ -1,4 +1,4 @@ -# Carbon Java Script — Allotrope Mixin System +# Carbon Lang Script — Allotrope Mixin System Allotrope is the advanced injection system built into Carbon Loader. It allows mods to inject raw Java code into Carbon Loader's Parent or Child classloader. diff --git a/docs/compiler/compiler-requirements.md b/docs/compiler/compiler-requirements.md index 7852199..6cd53cc 100644 --- a/docs/compiler/compiler-requirements.md +++ b/docs/compiler/compiler-requirements.md @@ -1,4 +1,4 @@ -# Carbon Java Script — Compiler & Runtime Requirements +# Carbon Lang Script — Compiler & Runtime Requirements This document is intended for the developer building the Carbon Lib mod and the CJ compiler. It describes everything the compiler and runtime must do. @@ -7,7 +7,7 @@ the CJ compiler. It describes everything the compiler and runtime must do. ## Overview -The Carbon Java Script compiler is built into Carbon Lib (a Fabric mod). +The Carbon Lang Script compiler is built into Carbon Lib (a Fabric mod). It runs entirely at mod-load time — modders never run a compiler themselves. The compiler takes `.cj` source files and produces JVM bytecode via ASM. diff --git a/docs/getting-started/01_your_first_mod.md b/docs/getting-started/01_your_first_mod.md index e3b6b49..228d75e 100644 --- a/docs/getting-started/01_your_first_mod.md +++ b/docs/getting-started/01_your_first_mod.md @@ -67,7 +67,7 @@ What each line means: | Line | What it does | |------|-------------| -| `carbonjava` | Marks this as a Carbon Java file. Every .cj file starts with this. | +| `carbonjava` | Marks this as a Carbon Lang file. Every .cj file starts with this. | | `add item` | You are defining a new item. | | `name (ruby)` | The item's ID. Shows in game as "Ruby". | | `type ingredient` | This item is used for crafting. | diff --git a/docs/getting-started/02_folder_structure.md b/docs/getting-started/02_folder_structure.md index 05b3823..c695635 100644 --- a/docs/getting-started/02_folder_structure.md +++ b/docs/getting-started/02_folder_structure.md @@ -16,7 +16,7 @@ my_mod.zip │ ├── models/ ← 3D model files (.glb) │ └── sounds/ ← Audio files │ -└── src/ ← All your Carbon Java scripts +└── src/ ← All your Carbon Lang scripts ├── definitions/ ← Where you define things that exist in the game │ ├── items.cj ← Your custom items │ ├── blocks.cj ← Your custom blocks diff --git a/docs/getting-started/03_carbon_mod_json.md b/docs/getting-started/03_carbon_mod_json.md index 3d46b1a..856bffa 100644 --- a/docs/getting-started/03_carbon_mod_json.md +++ b/docs/getting-started/03_carbon_mod_json.md @@ -46,7 +46,7 @@ There are three types of Carbon mod: | Type | What it means | |------|--------------| -| `"carbon"` | A normal mod made with Carbon Java scripts. This is what you want. | +| `"carbon"` | A normal mod made with Carbon Lang scripts. This is what you want. | | `"allotrope"` | An advanced mod that injects code into Carbon Loader itself. Requires Java knowledge. | | `"fabric"` | A regular Fabric mod that wants to connect to Carbon Loader features. | diff --git a/docs/index.md b/docs/index.md index 595b162..1d87fd9 100644 --- a/docs/index.md +++ b/docs/index.md @@ -8,7 +8,7 @@ You do **not** need to know Java, Gradle, or any complicated tools. If you can w ## What is a Carbon Mod? -A Carbon mod is a `.zip` file you drop into your mods folder. Inside that zip are scripts written in Carbon Java, plus any textures, models, or sounds your mod uses. Carbon Loader reads the zip, compiles your scripts on the fly, and loads your mod into the game — no building required. +A Carbon mod is a `.zip` file you drop into your mods folder. Inside that zip are scripts written in Carbon Lang, plus any textures, models, or sounds your mod uses. Carbon Loader reads the zip, compiles your scripts on the fly, and loads your mod into the game — no building required. --- @@ -24,7 +24,7 @@ A Carbon mod is a `.zip` file you drop into your mods folder. Inside that zip ar ### The Language | File | What it covers | |------|---------------| -| language/01_basics/ | How Carbon Java works, comments, structure | +| language/01_basics/ | How Carbon Lang works, comments, structure | | language/02_logic_and_variables/ | If statements, variables, loops | | language/03_items/ | Adding custom items, weapons, food, armor | | language/04_blocks/ | Adding custom blocks | diff --git a/docs/language/01_basics.md b/docs/language/01_basics.md index 3184b73..a6b7308 100644 --- a/docs/language/01_basics.md +++ b/docs/language/01_basics.md @@ -1,6 +1,6 @@ -# The Basics of Carbon Java +# The Basics of Carbon Lang -Carbon Java is designed to be as simple as possible. This page explains how a `.cj` file works from top to bottom. +Carbon Lang is designed to be as simple as possible. This page explains how a `.cj` file works from top to bottom. --- @@ -12,7 +12,7 @@ Every single `.cj` file must start with this on the very first line: carbonjava ``` -That's it. No brackets, no semicolons. Just that word. It tells Carbon Loader "this is a Carbon Java file." +That's it. No brackets, no semicolons. Just that word. It tells Carbon Loader "this is a Carbon Lang file." If you forget it, the file won't load. @@ -39,7 +39,7 @@ Use comments to remind yourself what things do, especially when you come back to ## Blocks -Almost everything in Carbon Java is written inside a **block**. A block starts with `add` and ends with `end`. +Almost everything in Carbon Lang is written inside a **block**. A block starts with `add` and ends with `end`. ``` add item @@ -102,7 +102,7 @@ The path starts from inside the `src/` folder. ## Indentation -Carbon Java does **not** require indentation. These two blocks are identical to the compiler: +Carbon Lang does **not** require indentation. These two blocks are identical to the compiler: ``` add item diff --git a/docs/language/02_logic_and_variables.md b/docs/language/02_logic_and_variables.md index 411ccb9..a05dd08 100644 --- a/docs/language/02_logic_and_variables.md +++ b/docs/language/02_logic_and_variables.md @@ -1,6 +1,6 @@ # Logic and Variables -This page covers how to make decisions, store information, and repeat things in Carbon Java. +This page covers how to make decisions, store information, and repeat things in Carbon Lang. --- @@ -83,7 +83,7 @@ run (scripts/normal.cj) ### And — `anif` -Because Carbon Java doesn't use indentation for logic, "and" is written as `anif` on the next line: +Because Carbon Lang doesn't use indentation for logic, "and" is written as `anif` on the next line: ``` if (holding) diff --git a/docs/language/actions.md b/docs/language/actions.md index 26973c3..b9833cc 100644 --- a/docs/language/actions.md +++ b/docs/language/actions.md @@ -1,4 +1,4 @@ -# Carbon Java Script — Actions & Execution +# Carbon Lang Script — Actions & Execution --- diff --git a/docs/language/blocks.md b/docs/language/blocks.md index e8baae4..2653b85 100644 --- a/docs/language/blocks.md +++ b/docs/language/blocks.md @@ -1,4 +1,4 @@ -# Carbon Java Script — Block Types & Properties +# Carbon Lang Script — Block Types & Properties --- diff --git a/docs/language/events.md b/docs/language/events.md index b504d6a..900c1cf 100644 --- a/docs/language/events.md +++ b/docs/language/events.md @@ -1,4 +1,4 @@ -# Carbon Java Script — Events +# Carbon Lang Script — Events Events are used with `on` inside any `add` block, or standalone in action scripts. diff --git a/docs/language/logic.md b/docs/language/logic.md index aafa263..31109de 100644 --- a/docs/language/logic.md +++ b/docs/language/logic.md @@ -1,4 +1,4 @@ -# Carbon Java Script — Logic, Conditions & Loops +# Carbon Lang Script — Logic, Conditions & Loops --- @@ -25,7 +25,7 @@ run (normal.cj) ## `anif` — And If Used when you need multiple conditions to all be true. -Because there is no indentation in Carbon Java, `anif` replaces chained `and` conditions. +Because there is no indentation in Carbon Lang, `anif` replaces chained `and` conditions. ``` if (holding) diff --git a/docs/language/recipes.md b/docs/language/recipes.md index 5c73b04..93fcb9c 100644 --- a/docs/language/recipes.md +++ b/docs/language/recipes.md @@ -1,4 +1,4 @@ -# Carbon Java Script — Recipes +# Carbon Lang Script — Recipes Recipe files live in `src/recipes/` and use a special simplified format. They do not start with `carbonjava` — they are purely data files. diff --git a/docs/language/syntax.md b/docs/language/syntax.md index 26eb0e9..5af2294 100644 --- a/docs/language/syntax.md +++ b/docs/language/syntax.md @@ -1,9 +1,9 @@ -# Carbon Java Script — Core Syntax +# Carbon Lang Script — Core Syntax ## File Header Every `.cj` file must begin with `carbonjava` on the very first line. -This identifies the file as a Carbon Java Script file. +This identifies the file as a Carbon Lang Script file. ``` carbonjava diff --git a/docs/language/variables.md b/docs/language/variables.md index 57d83cf..9d0bc39 100644 --- a/docs/language/variables.md +++ b/docs/language/variables.md @@ -1,4 +1,4 @@ -# Carbon Java Script — Variables, Types & Persistent Data +# Carbon Lang Script — Variables, Types & Persistent Data --- diff --git a/docs/reference/02_targets.md b/docs/reference/02_targets.md index 7c080ab..a099565 100644 --- a/docs/reference/02_targets.md +++ b/docs/reference/02_targets.md @@ -1,6 +1,6 @@ # Targets Reference -Targets tell Carbon Java *who* an action applies to. They are used in `effect`, `damage`, `spawn`, `teleport`, and similar action lines. +Targets tell Carbon Lang *who* an action applies to. They are used in `effect`, `damage`, `spawn`, `teleport`, and similar action lines. --- diff --git a/docs/structure/carbon-mod-json.md b/docs/structure/carbon-mod-json.md index 6e8eb55..70d6838 100644 --- a/docs/structure/carbon-mod-json.md +++ b/docs/structure/carbon-mod-json.md @@ -101,7 +101,7 @@ Carbon defaults to child injection when no parent/child split is specified. | Type | Description | |------|-------------| -| `"carbon"` | A standard Carbon Java Script mod. | +| `"carbon"` | A standard Carbon Lang Script mod. | | `"allotrope"` | Injects Java into Carbon Loader via mixins. | | `"fabric"` | A Fabric mod that uses carbon.mod.json for Carbon ecosystem compatibility. | diff --git a/docs/structure/folder-structure.md b/docs/structure/folder-structure.md index 2ef96e2..d65a688 100644 --- a/docs/structure/folder-structure.md +++ b/docs/structure/folder-structure.md @@ -1,4 +1,4 @@ -# Carbon Java Script — Mod Folder Structure +# Carbon Lang Script — Mod Folder Structure Carbon mods are distributed as `.zip` files. Carbon Lib unzips them at runtime into a temp directory and loads them. No build step is required from the modder. @@ -17,7 +17,7 @@ my_awesome_mod.zip │ ├── models/ # Custom 3D models (.glb or .obj) │ └── sounds/ # Audio files (.mp3, .ogg) │ -└── src/ # All Carbon Java Script logic +└── src/ # All Carbon Lang Script logic ├── definitions/ # Global registration │ ├── mobs.cj # All "add mob" declarations │ ├── blocks.cj # All "add block" declarations