Goodecode

Goodecode 0.0.68 uses one canonical, single-file Python project model. New projects define configure_project, configure_robot, exactly four autonomous slots in configure_autonomous, and configure_controls; configure_sensor_logic is generated only when sensors exist. Each physical Smart Port is declared once—motor groups must not be duplicated as individual motor declarations. The same schema-v2 contract feeds Cortex, the V5 Brain model, and the Goodebot Digital Twin.

Imported projects may also declare an optional hardware profile. Every physical input remains unavailable until verified from CAD, hardware measurements, or guided calibration.

Device declarations use stable IDs inside an explicitly managed hardware region. Sidebar edits touch only the changed source range and preserve user code. For an older project, run Goodecode: Create Template 2.1 Migration Copy to create a separate reviewable copy without overwriting the original.

Goodecode is the Python authoring extension for Goodebot. Create a project, write robot code, validate the project structure, export a .goode package, and continue the hardware, preview, and deployment workflow in the Goodebot desktop app.

Independent third-party project. Not affiliated with VEX Robotics.

Goodebot and Goodecode are independent, third-party projects. They are not affiliated with, endorsed by, sponsored by, or approved by VEX Robotics, Inc., Innovation First, Inc., or the Robotics Education & Competition Foundation. VEX and VEX Robotics are trademarks or service marks of Innovation First, Inc. All other product names and marks belong to their respective owners. Product references are used only to describe compatibility.

What Goodecode Does

• Creates Goodecode Python project structure.
• Provides syntax highlighting, snippets, and Studio navigation.
• Provides a declaration-only Devices sidebar for motors, pneumatics, IMU, and source-managed sensors.
• Updates the marked configure_robot declaration block without generating robot behavior.
• Validates project structure before export.
• Exports source-first .goode packages for Goodebot import.
• Opens Goodebot for hardware configuration, previews, and deployment preparation.

What The Goodebot Desktop App Does

Goodebot handles robot profiles, hardware configuration, controller mappings, Practice and Competition profiles, Brain Preview, Digital Twin software preview, Goodebot Runtime build, reports, update management, and physical upload preparation.

Quick Start

1. Install Goodecode from VS Code.
2. Open a folder.
3. Run Goodecode: Open Goodecode.
4. Create or open a Goodecode project.
5. Export a .goode package.
6. Import it into Goodebot.

Supported File Types

• .goode.py
• .goodecode
• .goode
• goodecode.toml

Requirements

• VS Code 1.90 or newer.
• Python for local project workflows.
• Goodebot desktop app for hardware configuration and deployment preparation.
• macOS 14 or newer for the current primary Goodebot app.

Feature Status

Network And Update Behavior

Goodecode may contact GitHub for Goodecode project and extension release features. Goodebot application downloads are opened exclusively at https://goodebot.net/download; the extension does not download, install, extract, or update the desktop app. Failed release checks do not block coding. Goodecode does not include product-usage analytics or advertising trackers.

Privacy

Goodecode does not upload robot source code by default. GitHub profile synchronization and update checks are opt-in or user-triggered workflows. See ../00-goodebot-meta/PRIVACY.md.

Security

Goodecode must not delete macOS quarantine attributes or bypass Gatekeeper. Public Goodebot downloads must be HTTPS, hash checked when a manifest is present, verified as app bundles, and assessed by macOS security checks before replacement. See ../00-goodebot-meta/SECURITY.md.

Support

Use ../00-goodebot-meta/SUPPORT.md for bug reports and beta support guidance.

Known Limitations

• Physical upload is not marketed as stable until documented physical-hardware test coverage exists.
• Digital Twin is a software preview of configured behavior, not an exact V5 Brain or firmware emulator.
• Goodecode is not VEXcode and is not supplied by VEX Robotics.

Trademark Notice

Product references such as VEX V5, VEXcode, and VEXos are used only to describe compatibility or external tools.