Parts format (JSON)Teile-Format (JSON)

#Files and loadingDateien und Laden

src/main/resources/data/<namespace>/propwash_parts/<category>/<path>.json

• Categories are the folder names: frame, stack, motor, prop, video, battery, accessory, chemistry. Sub-folders and other folder names are errors.Kategorien sind die Ordnernamen: frame, stack, motor, prop, video, battery, accessory, chemistry. Unterordner und andere Ordnernamen sind Fehler.
• The id is <namespace>:<file name without .json>; the path may only contain [a-z0-9_.-] and must be unique across all categories.Die Id ist <namensraum>:<dateiname ohne .json>; der Pfad darf nur [a-z0-9_.-] enthalten und muss über alle Kategorien eindeutig sein.
• Files are loaded only by PropwashApi.parts().loadBundled(modId) from the add-on’s own jar, in the order chemistry → frame → stack → motor → prop → video → battery → accessory, alphabetically within a folder. Not from world data packs, no /reload.Geladen werden die Dateien nur von PropwashApi.parts().loadBundled(modId) aus dem eigenen Jar des Add-ons, in der Reihenfolge chemistry → frame → stack → motor → prop → video → battery → accessory, innerhalb eines Ordners alphabetisch. Nicht aus Welt-Datenpaketen, kein /reload.
• Propwash’s own 38 built-in parts and chemistries are files in exactly this format.Propwashs eigene 38 eingebaute Teile und Zellchemien sind Dateien in genau diesem Format.

#ConventionsKonventionen

• Ids without a namespace ("m22", "lipo") mean propwash:…. Always write other namespaces in full.Ids ohne Namensraum ("m22", "lipo") meinen propwash:…. Andere Namensräume immer voll schreiben.
• Numbers are JSON numbers; integers must not have decimals ("kv": 1750, not 1750.5).Zahlen sind JSON-Zahlen; ganze Zahlen dürfen keine Nachkommastellen haben ("kv": 1750, nicht 1750.5).
• [min, max] ranges may also be a single number for cells ("cells": 6 = [6, 6]).[min, max]-Bereiche dürfen bei cells auch eine einzelne Zahl sein ("cells": 6 = [6, 6]).
• Positions are [x, y, z] in millimetres: origin in the middle of the frame at the height of the stack plate, +X right, +Y up, −Z forward.Positionen sind [x, y, z] in Millimetern: Ursprung in der Rahmenmitte auf Höhe der Stack-Auflage, +X rechts, +Y oben, −Z vorn.
• "format": 1 is optional. New optional fields can come with minor API versions; the format number only rises for incompatible changes."format": 1 ist optional. Neue optionale Felder können mit Nebenversionen der API kommen; die Formatnummer steigt nur bei inkompatiblen Änderungen.

#Fields of every partFelder jedes Teils

#Frame frameRahmen frame

Folder propwash_parts/frame/, plus the fields of every part.

Ordner propwash_parts/frame/, dazu die Felder jedes Teils.

{
  "format": 1,
  "mass_g": 125.0,
  "role": "freestyle",
  "shape": "true_x",
  "wheelbase_mm": 225,
  "max_prop_mm": 130,
  "motor_mounts": ["propwash:m22"],
  "stack_mounts": ["propwash:s30"],
  "accessory_mounts": ["top", "bottom", "front"],
  "battery": {"on_top": true, "plate_mm": 30.0},
  "electronics_mm": 12.0,
  "camera": {"pos": [0.0, 17.2, -58.8], "tilt_deg": 28.0},
  "accessory_anchors": {
    "top": {"pos": [0.0, 34.7, -69.0], "tilt_deg": 22.0, "length_mm": 0.0},
    "bottom": {"pos": [0.0, -3.0, -56.0], "tilt_deg": 30.0, "length_mm": 34.0},
    "front": {"pos": [0.0, 0.0, -72.0], "tilt_deg": 0.0, "length_mm": 0.0}
  },
  "aero": {"frontal_area_m2": 0.012, "drag_coefficient": 0.9},
  "impact_tolerance": 8.0,
  "battery_fit": {"cells": [4, 6], "max_mass_g": 230.0, "preferred_min_cells": 6, "preferred_min_capacity_mah": 0},
  "sort": 2
}

#Stack (flight controller and ESC) stackStack (Flight-Controller und ESC) stack

Folder propwash_parts/stack/, plus the fields of every part.

Ordner propwash_parts/stack/, dazu die Felder jedes Teils.

{
  "format": 1,
  "mass_g": 18.0,
  "mount": "propwash:s30",
  "esc_continuous_a": 55.0,
  "cells": [3, 6],
  "all_in_one": false,
  "sort": 2
}

#Motor motor

Folder propwash_parts/motor/, plus the fields of every part.

Ordner propwash_parts/motor/, dazu die Felder jedes Teils.

{
  "format": 1,
  "mass_g": 33.0,
  "stator": "2207",
  "kv": 1750,
  "mount": "propwash:m22",
  "max_current_a": 45.0,
  "resistance_ohm": 0.055,
  "cells": [6, 6],
  "sort": 3,
  "visual": {"accent": "#e8b622"}
}

#Propeller prop

Folder propwash_parts/prop/, plus the fields of every part.

Ordner propwash_parts/prop/, dazu die Felder jedes Teils.

{
  "format": 1,
  "mass_g": 4.3,
  "diameter_mm": 130,
  "pitch_in": 4.6,
  "blades": 3,
  "ct": 0.12,
  "cp": 0.06,
  "material": "polycarbonate",
  "sort": 3,
  "visual": {"accent": "#ff7a1a"}
}

#Video unit videoVideomodul video

Folder propwash_parts/video/, plus the fields of every part.

Ordner propwash_parts/video/, dazu die Felder jedes Teils.

{
  "format": 1,
  "mass_g": 8.0,
  "link": "analog",
  "latency_ms": 12,
  "range_blocks": 380,
  "image_quality": 0.65,
  "camera_width_mm": 19.0,
  "camera_fov_deg": 125.0,
  "vtx_power_mw": 400,
  "vtx_levels_mw": [25, 200, 400, 800, 1600],
  "power_w": 3.5,
  "sort": 1
}

#Battery batteryAkku battery

Folder propwash_parts/battery/, plus the fields of every part.

Ordner propwash_parts/battery/, dazu die Felder jedes Teils.

{
  "format": 1,
  "mass_g": 210.0,
  "cells": 6,
  "capacity_mah": 1300,
  "cell_resistance_ohm": 0.0055,
  "c_rating": 120,
  "chemistry": "propwash:lipo",
  "sort": 3,
  "visual": {"accent": "#2f6fd6"}
}

#Accessory accessoryZubehör accessory

Folder propwash_parts/accessory/, plus the fields of every part.

Ordner propwash_parts/accessory/, dazu die Felder jedes Teils.

{
  "format": 1,
  "mass_g": 42.0,
  "slot": "top",
  "size_mm": [46.0, 30.0, 26.0],
  "flight_battery_w": 4.0,
  "frontal_area_m2": 0.0014,
  "lens": {"x_mm": 0.0, "length_mm": 7.0},
  "action_cam": {
    "max_height": 1080,
    "max_fps": 60,
    "stabilization": false,
    "horizon_levelling": false,
    "own_battery_wh": 0.0,
    "record_w": 4.0,
    "max_record_w": 4.0,
    "fov_deg": 150.0,
    "image_quality": 0.8,
    "low_light_noise": 0.55,
    "sensor_in": "1/2.8"
  },
  "sort": 1
}

#Cell chemistry chemistryZellchemie chemistry

Chemistries are not parts and have no common fields; batteries refer to them by id. Register or load them before the batteries that use them.

Zellchemien sind keine Teile und haben keine gemeinsamen Felder; Akkus verweisen per Id auf sie. Vor den Akkus anmelden oder laden, die sie benutzen.

{
  "format": 1,
  "full_v": 4.2,
  "nominal_v": 3.7,
  "empty_v": 3.5,
  "cutoff_v": 3.3,
  "storage_v": 3.8,
  "density_g_cm3": 2.0,
  "usable_fraction": 0.8,
  "ocv_shape": [0.0, 0.16, 0.27, 0.33, 0.37, 0.4, 0.43, 0.5, 0.61, 0.73, 0.86, 1.0]
}

#Built-in idsEingebaute Ids

Mounts of the built-in parts, to make own parts fit them:

Halterungen der eingebauten Teile, damit eigene Teile dazu passen:

Built-in parts and chemistries, for presets that mix them with own parts:

Eingebaute Teile und Zellchemien, für Presets, die sie mit eigenen Teilen mischen:

#Example with own armsBeispiel mit eigenen Armen

A deadcat frame from the example add-on: own arm positions and spin directions, the camera far enough in front of the front props, both accessory mounts. "creative": false keeps it out of the creative tab; leave it out for your own parts.

Ein Deadcat-Rahmen aus dem Beispiel-Add-on: eigene Armpositionen und Drehrichtungen, die Kamera weit genug vor den Vorderprops, beide Zubehör-Halterungen. "creative": false hält ihn aus dem Kreativ-Tab; bei eigenen Teilen einfach weglassen.

{
  "format": 1,
  "mass_g": 118.0,
  "creative": false,
  "role": "freestyle",
  "shape": "deadcat",
  "wheelbase_mm": 230,
  "max_prop_mm": 130,
  "motor_mounts": ["propwash:m22"],
  "stack_mounts": ["propwash:s30", "propwash:s20"],
  "accessory_mounts": ["top", "bottom"],
  "arms": {
    "front_left": {"pos": [-95.0, 0.0, -60.0], "spin": "cw"},
    "front_right": {"pos": [95.0, 0.0, -60.0], "spin": "ccw"},
    "rear_left": {"pos": [-80.0, 0.0, 80.0], "spin": "ccw"},
    "rear_right": {"pos": [80.0, 0.0, 80.0], "spin": "cw"}
  },
  "battery": {"on_top": true, "plate_mm": 30.0},
  "electronics_mm": 12.0,
  "camera": {"pos": [0.0, 14.0, -100.0], "tilt_deg": 30.0},
  "center_of_mass_mm": [0.0, 0.0, 6.0],
  "aero": {"frontal_area_m2": 0.012, "drag_coefficient": 0.9},
  "impact_tolerance": 8.0,
  "battery_fit": {"cells": [4, 6], "max_mass_g": 260.0, "preferred_min_cells": 6, "preferred_min_capacity_mah": 0}
}

#Errors and warningsFehler und Warnungen

• Propwash first reads all files. If any has an error, loadBundled throws one exception listing every error as file – field: message and registers nothing.Propwash liest zuerst alle Dateien. Hat eine einen Fehler, wirft loadBundled eine Ausnahme mit jedem Fehler als Datei – Feld: Meldung und meldet nichts an.
• Unknown fields are not errors: they are logged as a warning and ignored, so a file written for a newer Propwash still loads.Unbekannte Felder sind keine Fehler: Sie landen als Warnung im Log und werden ignoriert, damit eine Datei für ein neueres Propwash trotzdem lädt.
• PropwashEvents.PART_REGISTERED fires for every part (not for chemistries).PropwashEvents.PART_REGISTERED feuert für jedes Teil (nicht für Zellchemien).