ViAllay

ViAllay is an AllayMC plugin that enables Java Edition players to join Bedrock Edition servers. It brings the power of ViaVersion and ViaBedrock to the AllayMC ecosystem.

Features

• Java to Bedrock Translation - Allows Minecraft Java Edition clients to connect to AllayMC Bedrock servers
• Wide Version Support - Supports a broad range of Java Edition client versions through ViaVersion, ViaBackwards, ViaRewind, and ViaLegacy
• Seamless Integration - Works as a native AllayMC plugin with full configuration support
• Custom Server Status - Configurable MOTD and max players display
• Privacy Compliant - Optional IP address logging (GDPR friendly)

How It Works

┌─────────────────┐         ┌─────────────┐         ┌─────────────────┐
│  Java Edition   │  TCP    │   ViAllay   │  RakNet │  AllayMC Server │
│     Client      │ ──────► │   (Proxy)   │ ──────► │    (Bedrock)    │
└─────────────────┘         └─────────────┘         └─────────────────┘
                                  │
                    ┌─────────────┴──────────────┐
                    │     Protocol Translation   │
                    │  ViaVersion + ViaBedrock   │
                    └────────────────────────────┘

ViAllay acts as a protocol translation proxy:

1. Java Edition clients connect to ViAllay via TCP (default port 25565)
2. ViAllay translates Java Edition protocol to Bedrock Edition protocol using ViaVersion stack
3. Translated packets are forwarded to the AllayMC Bedrock server via RakNet

Requirements

• AllayMC Server - Version 0.23.0 or later
• Java - Version 21 or later

Installation

1. Download the latest ViAllay-x.x.x-shaded.jar from Releases
2. Place the JAR file in your AllayMC server's plugins folder
3. Start or restart the server
4. Configure plugins/ViAllay/viallay.yml as needed
5. Restart the server to apply configuration changes

Configuration

Configuration file: plugins/ViAllay/viallay.yml

# Network Settings
network-settings:
  bind-address: "0.0.0.0"    # Address to listen on (0.0.0.0 = all interfaces)
  bind-port: 25565           # Port for Java Edition clients
  connect-timeout: 8000      # Backend connection timeout (ms)

# Bedrock Backend Settings
bedrock-backend-settings:
  bedrock-host: "127.0.0.1"  # AllayMC server address
  bedrock-port: 19132        # AllayMC server port

# Protocol Settings
protocol-settings:
  compression-threshold: 256              # Packet compression threshold (-1 to disable)
  ignore-protocol-translation-errors: false
  suppress-client-protocol-errors: false

# Server Status Settings (shown in Java server list)
server-status-settings:
  motd: ""                   # Custom MOTD (empty = use backend server's MOTD)
  max-players: -1            # Custom max players (-1 = use backend server's value)

# Logging Settings
logging-settings:
  log-ips: true              # Log player IP addresses
  log-status-requests: false # Log server list ping requests
  protocol-debug: false      # Enable protocol debug logging

# Authentication Settings
authentication-settings:
  online-mode: false         # Mojang authentication (not yet implemented)

Supported Versions

Java Edition Clients

ViAllay supports a wide range of Java Edition versions through the ViaVersion protocol translation stack:

• Modern versions (1.21.x, 1.20.x, etc.)
• Legacy versions via ViaBackwards and ViaRewind
• Ancient versions via ViaLegacy

Bedrock Server

• AllayMC with latest Bedrock protocol support

Building from Source

# Clone the repository
git clone https://github.com/AllayMC/ViAllay.git
cd ViAllay

# Build with Gradle
./gradlew build

# The shaded JAR will be in build/libs/

Credits

ViAllay is built upon the excellent work of:

• ViaVersion - Core protocol translation framework
• ViaBackwards - Backwards compatibility support
• ViaRewind - Legacy version support
• ViaLegacy - Ancient version support
• ViaBedrock - Java to Bedrock translation
• ViaProxy - Architecture reference and inspiration
• NetMinecraft - Minecraft networking library

Special thanks to RaphiMC for the incredible Via* ecosystem!

License

This project is licensed under the GPL-3.0 License.

Links

• AllayMC - The Bedrock server software
• ViaVersion Project - Protocol translation ecosystem
• Issue Tracker - Report bugs and request features