RedisHostVelocity

RedisHostVelocity
RedisHostVelocity is a lightweight Redis-compatible TCP server built as a Velocity plugin. It lets backend Minecraft servers and Redis-aware plugins connect to your Velocity proxy as if it were a Redis server, removing the need for a separate Redis instance for simple Minecraft network-sync workloads.

Source:
https://github.com/HealingHalo8/VelocityRedisHost/tree/main

What It Does
RedisHostVelocity emulates a useful subset of Redis for Minecraft network infrastructure, including:

• Cross-server transfer handoffs
  
  
• Server/proxy status syncing
  
  
• Lightweight cache data
  
  
• Pub/Sub messaging
  
  
• Global counters
  
  
• Plugin-to-plugin communication
  
  
• Team, event, and leaderboard-style data
  
  
• Temporary player/session data

It supports Redis-style TCP connections, RESP command parsing, password authentication, multiple logical databases, key expiration, persistence, and common Redis client startup commands.

Supported Features
RedisHostVelocity includes support for common Redis command groups:

Connection:
AUTH, PING, HELLO, CLIENT SETINFO, CLIENT SETNAME, SELECT, QUIT

Strings:
GET, SET, SETEX, MGET, MSET, INCR, DECR, APPEND, STRLEN

Hashes:
HSET, HGET, HGETALL, HMGET, HDEL, HEXISTS, HKEYS, HVALS

Lists:
LPUSH, RPUSH, LPOP, RPOP, LRANGE, LINDEX, LLEN

Sets:
SADD, SREM, SMEMBERS, SISMEMBER, SCARD

Sorted Sets:
ZADD, ZREM, ZRANGE, ZREVRANGE, ZSCORE, ZCARD

Keys / TTL:
DEL, EXISTS, EXPIRE, TTL, TYPE, KEYS, SCAN, DBSIZE

Pub/Sub:
PUBLISH, SUBSCRIBE, UNSUBSCRIBE, PSUBSCRIBE, PUNSUBSCRIBE

Some commands are full implementations, while others are compatibility stubs for Redis clients like Lettuce and Jedis.

Persistence
RedisHostVelocity includes local persistence through:

• Snapshot-style saving
  
  
• Append-only style logging
  
  
• Startup reload support
  
  
• Binary-safe value handling
  
  
• Safer large AOF recovery
  
  
• Automatic append-only cleanup/compaction safeguards

Persistence is intended for lightweight Minecraft plugin data, not massive production Redis datasets.

v1.1.6 Persistence Improvements
Version 1.1.6 adds stronger protection around append-only files and startup recovery.

This update includes:

• Safer startup recovery for large append-only files
  
  
• Async AOF recovery so Velocity can finish loading instead of freezing
  
  
• Protection against corrupt or incomplete AOF lines
  
  
• Automatic AOF cleanup/compaction safeguards
  
  
• Reduced unnecessary AOF growth from redundant writes
  
  
• Better /redishost save behavior
  
  
• Protection against append files growing out of control
  
  
• Improved handling for large AOF files with days of Redis write history

Recommended persistence config:

persistence:
enabled: true
snapshot-enabled: true
appendonly-enabled: true

aof-auto-rewrite-enabled: true
aof-auto-rewrite-min-size-mb: 96
aof-auto-rewrite-min-changes: 1000
aof-auto-rewrite-cooldown-seconds: 300
aof-log-select-on-change-only: true
aof-skip-noop-writes: true

recovery:
async-startup-load: true
compact-after-startup-recovery: false
aof-replay-progress-lines: 50000
aof-startup-delay-seconds: 10
aof-replay-yield-lines: 5000
aof-replay-yield-millis: 5

After updating, it is recommended to run:

/redishost save

This creates a cleaner saved state using the updated persistence system.

Not a Full Redis Replacement
RedisHostVelocity does not implement every Redis feature. It is not recommended for plugins that require:

• Lua scripting
  
  
• EVAL / EVALSHA
  
  
• Redis Cluster
  
  
• Redis Sentinel
  
  
• Streams
  
  
• Redis modules
  
  
• Full ACL management
  
  
• Strict transaction guarantees
  
  
• Large production Redis workloads

If a plugin depends on advanced Redis behavior, use a real Redis server instead.

Requirements

• Velocity proxy
  
  
• Java 21+
  
  
• Backend plugins configured to connect to RedisHostVelocity
  
  
• An exposed port matching the RedisHostVelocity config

Basic Setup

1. Place the jar in your Velocity plugins folder.
   
   
2. Start the proxy once to generate the config.
   
   
3. Set the bind host, port, password, database count, memory limit, and persistence options.
   
   
4. Restart Velocity.
   
   
5. Point backend plugins to the Velocity proxy IP/domain and RedisHostVelocity port.

Example backend config:

host: "your-proxy-ip"
port: 25738
password: "your-password"
database: 0
ssl: false

Startup should show:

RedisHost listening on 0.0.0.0:25738

Upgrade Notes
Before updating, make a backup of your RedisHost data files:

appendonly.rbst.aof
dump.rdb

Then replace the old RedisHostVelocity jar with the new version and restart Velocity.

After the server loads successfully, run:

/redishost save

Project Goal
RedisHostVelocity provides a fast, simple, Minecraft-focused Redis compatibility layer for networks that need Redis-style communication without running a separate Redis provider.

It is designed for small-to-medium Minecraft network sync workloads where a full external Redis setup may not be practical.