ProxyFeatures

One modular feature framework for your entire Velocity network.

Quick Start

1. Place ProxyFeatures.jar in your Velocity plugins/ directory.
2. Install dependencies: dataregistry and dataprovider.
3. Start the proxy once to generate defaults.
4. Enable the features you want in config.yml.
5. Restart and go live.

Requirements

• Java 25
• Velocity 4.1.0-SNAPSHOT
• DataRegistry 1.12.0 for DataRegistry-backed features
• DataProvider 3.1.0 for persistent features

Build From Source

Add GitHub Packages credentials for Maven server id github in ~/.m2/settings.xml:

<settings>
  <servers>
    <server>
      <id>github</id>
      <username>YOUR_GITHUB_USERNAME</username>
      <password>YOUR_TOKEN</password>
    </server>
  </servers>
</settings>

Use a token with read:packages (and repo if the package source repositories are private), then run:

./mvnw -B -ntp verify

Output jar: target/ProxyFeatures.jar

Run the real Velocity acceptance gate (Docker required) with:

./mvnw -B -ntp -Pplatform-acceptance verify

It boots the packaged ProxyFeatures jar with the bundled DataProvider and DataRegistry releases, then checks their public runtime integration and clean shutdown. Set PLATFORM_ACCEPTANCE_KEEP_WORK_DIRECTORY=true to retain logs.

Learn More

• Configuration Guide
• Documentation Index
• Architecture
• Development Notes
• Testing and Quality
• Contributing

Community

• Support
• Security Policy
• Code of Conduct