# Proxy Compatible Forge<\/p>\n
\n
\n<\/p>\n
\n<\/p>\n
Special thanks to FabricProxy-Lite and
\nCrossStitch for spearheading in the modded proxy space. We’ve done
\nour fair share of work porting things and tailoring them to a Neo\/Forge environment, but nonetheless we stand on the shoulders of giants.<\/p>\n
This mod brings Velocity’s modern forwarding to Neo\/Forge servers<\/p>\n
## Supported Versions\/Platforms<\/p>\n
– Forge versions 1.7.2 – 26.1.2
\n – MixinBootstrap is required on Forge 1.14 – 1.15.1
\n – ModernMixins is required on Forge 1.13.x
\n – MixinBooter is required on Forge 1.8 – 1.12.2
\n – UniMixins is required on Forge 1.7.x
\n – 1.7.2 – 1.12.2 also require a modified Velocity proxy
\n– NeoForge versions 1.20.1 – 26.1.2
\n– SpongeForge\/SpongeNeo
\n – PCF shouldn’t be needed, as Sponge supports legacy+modern forwarding and command argument wrapping
\n – However, if Forgified Fabric API is installed (specifically `fabric_networking_api_v1`), you may need to use PCF and disable Sponge’s forwarding
\n– Bukkit+Neo\/Forge Hybrid servers
\n – Use the Hybrid’s built-in forwarding support when possible, otherwise use PCF if their implementation is incompatible<\/p>\n
See the Compatibility page for more details on supported platforms and modpacks.<\/p>\n
## How to Get Started<\/p>\n
### Note Regarding Forge 1.13 – 1.20.1<\/p>\n
If you wish to host modern Forge server (1.13 – 1.20.1) behind a Velocity proxy, check out Ambassador: https:\/\/modrinth.com\/plugin\/ambassador<\/p>\n
*Note: Version 1.2.0-beta or higher of Ambassador doesn’t require this mod anymore, but you can still use it if you want modern forwarding.*<\/p>\n
### Installation<\/p>\n
The following assumes you’ve already configured a Velocity proxy and have a functional setup.<\/p>\n
1. Download this mod and place it in your Neo\/Forge server’s `mods` folder (Jars can be found on Modrinth or in the releases tab).
\n2. Start the Neo\/Forge server to generate the default config file.
\n3. Stop the Neo\/Forge server.
\n4. Open `proxy-compatible-forge.toml` in the `config` folder and put your forwarding secret in the `forwarding.secret` config field.
\n5. In `server.properties` make sure `online-mode` is set to `false`.
\n6. You are now ready to start the server and connect to it with Velocity!<\/p>\n
### Configuration<\/p>\n
The config is located under `config\/proxy-compatible-forge.toml` and has the following options:<\/p>\n
| Setting Group | Setting Name | Default Value | Description |
\n|—————|—————————–|—————–|——————————————————————————————————————————————————————————|
\n| `forwarding` | `enabled` | `true` | Enable or disable player info forwarding. Changing this setting requires a server restart. |
\n| `forwarding` | `mode` | `”MODERN”` | The type of forwarding to use. |
\n| `forwarding` | `secret` | `””` | The secret used to verify the player’s connection is coming from a trusted proxy. PCF will only handle argument wrapping if this setting is blank. |
\n| `forwarding` | `approvedProxyHosts` | `[]` | A list of approved proxy hostnames or IP addresses. If the connecting proxy’s hostname or IP isn’t in this list, the player will be disconnected. Leave empty to allow all. |
\n| `crossStitch` | `enabled` | `true` | Enable or disable CrossStitch support. Changing this setting requires a server restart. |
\n| `crossStitch` | `forceWrappedArguments` | `[]` | Add any incompatible modded or vanilla command argument types here. |
\n| `crossStitch` | `forceWrapVanillaArguments` | `false` | Force wrap vanilla command argument types. Useful for when the above setting gets a bit excessive. |
\n| `debug` | `enabled` | `false` | Enable or disable debug logging. |
\n| `debug` | `disabledMixins` | `[]` | List of mixins to disable. Use the Mixin’s name and prefix it with it’s partial or full package name. |
\n| `advanced` | `modernForwardingVersion` | `”NO_OVERRIDE”` | Overrides the modern forwarding version decided by PCF. Change it to “MODERN_DEFAULT” if you encounter chat-signing issues. Changing this setting requires a server restart. |<\/p>\n
## Features<\/p>\n
### Player Info Forwarding<\/p>\n
As mentioned above, PCF implements Velocity’s `MODERN` forwarding protocol, allowing you to secure modded
\nservers behind proxies.<\/p>\n
Modern Forwarding versions 1-4 are supported:<\/p>\n
| Name | Value | Supported MC Versions |
\n|———————————|——-|———————–|
\n| `MODERN_DEFAULT` | 1 | Any |
\n| `MODERN_FORWARDING_WITH_KEY` | 2 | 1.19 |
\n| `MODERN_FORWARDING_WITH_KEY_V2` | 3 | 1.19.1 – 1.19.2 |
\n| `MODERN_LAZY_SESSION` | 4 | 1.19.3 and above |<\/p>\n
If you run into compatibility issues regarding chat signing, report the issue, then change
\n`advanced.modernForwardingVersion` to `MODERN_DEFAULT` in PCF’s config.<\/p>\n
### Modded Command Argument Wrapping, aka CrossStitch<\/p>\n
This resolves errors such as:
\n“`
\nio.netty.handler.codec.CorruptedFrameException: Error decoding class com.velocitypowered.proxy.protocol.packet.AvailableCommandsPacket
\n“`<\/p>\n
PCF ports this Fabric mod’s ability to wrap modded command arguments, allowing them to be sent through Velocity without
\nthere needing to be a custom packet deserializer for each and every command argument mods add.<\/p>\n
In some rare cases mods will register their command arguments under the `minecraft` namespace or make modifications to
\nvanilla arguments, bypassing PCF’s argument wrapper. In such cases, you can add the custom argument’s ID to PCF’s
\n`crossStitch.forceWrappedArguments` setting to force PCF to wrap the argument.<\/p>\n
In situations where mods inject and register their arguments before Vanilla does, offsetting all the argument ID values,
\nyou can enable the `crossStitch.forceWrapVanillaArguments` setting to force-wrap the `minecraft` and `brigadier` namespaces.
\nThis is more of a band-aid solution as the offset argument IDs cannot be read by Velocity, and if the argument IDs on
\nthe client have the same offset Velocity commands cannot be read by the client, preventing connections entirely unless
\nyou disable all commands on the proxy via permissions or by removing plugins that add commands.<\/p>\n
The easiest way to tell if this is happening is to enable PCF’s debug logging in the config and check to see if
\n`brigadier:boolean` has an argument ID other than `0`.<\/p>\n
A common fix for this is for the mod in question to move their registration mixin to `RETURN`, and to ensure that their
\nargument’s registration specifies their modid as the namespace.<\/p>\n
If you find any wild args, please open an issue so we can add them to the default config, or so we can use the
\ninformation provided to write up a PR for the mod causing the issue.<\/p>\n
## Common Issues<\/p>\n
### Too Many Channels<\/p>\n
**Client Error:**
\n“`
\nInvalid payload REGISTER!
\n“`<\/p>\n
**Velocity:**<\/p>\n
Velocity Fix: Add `-Dvelocity.max-known-packs=#` to the Velocity’s startup arguments,
\nwhere `#` is a number that is 64 + number-of-mods*1.5 (round up).<\/p>\n
Eg: For 40 mods, use `64 + 40*1.5 = 124`, so `-Dvelocity.max-known-packs=124`<\/p>\n
**Paper Server Error:**
\n“`
\n[00:00:00 ERROR]: Couldn’t register custom payload
\njava.lang.IllegalStateException: Cannot register channel ‘modid:channel’. Too many channels registered!
\n“`<\/p>\n
Paper Fix: Add `-Dpaper.disableChannelLimit=true` to the Paper server’s startup arguments<\/p>\n
Notes: Due to the amount of channels and mods at play, textures\/items may be mismatched on the client when joining a Vanilla server.<\/p>\n
### An internal server connection error occurred<\/p>\n
**Client Error:**
\n“`
\nAn internal server connection error occurred.
\n“`<\/p>\n
**Velocity Error:**
\n“`
\nio.netty.handler.codec.CorruptedFrameException: Packet sent for class com.velocitypowered.proxy.protocol.packet.PluginMessagePacket was too big (expected 1234567 bytes, got 7654321 bytes)
\n“`<\/p>\n
Resolved Velocity-side with the by adding `-Dvelocity.max-plugin-message-payload-size=#######` to Velocity’s startup arguments,
\nwhere `#######` is a bit larger than the last “got ####### bytes” number in the error message. Repeat until your client is able to log in.<\/p>\n
## Building the Project<\/p>\n
1. Clone the repository. `git clone https:\/\/github.com\/adde0109\/Proxy-Compatible-Forge.git`<\/p>\n
2. Run `.\/gradlew build` (`gradlew.exe build` on Windows) in the root directory of the project<\/p>\n
3. The jar will be in `build\/libs\/`<\/p>\n","protected":false},"excerpt":{"rendered":"
This mod brings modern forwarding and useful patches to Neo\/Forge servers<\/p>\n","protected":false},"featured_media":125864,"template":"","meta":{"_minecraft_slug":"proxy-compatible-forge","_minecraft_project_id":"vDyrHl8l","_minecraft_author":"adde0109","_minecraft_license":"LGPL-2.1-or-later","_minecraft_downloads":42210,"_minecraft_follows":61,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"proxy-compatible-forge.zip","_minecraft_size_bytes":4210780,"_minecraft_version_count":38,"_minecraft_updated_at":"2026-05-16T11:49:50.769830Z","_minecraft_date_created":"2023-02-23T00:55:56.716371Z","_minecraft_date_modified":"2026-04-25T05:31:22.110728Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/proxy-compatible-forge","_minecraft_icon_attachment_id":125864,"_minecraft_imported_at":"2026-06-07T09:30:36+00:00","_minecraft_import_hash":"6a0b4bc7a766993d4ca042cc269e722e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[104,126,158,92],"mod_loader":[106,160],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,21,13,14,15,16,17,18,19,20,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864,83,167,163],"class_list":["post-125863","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-forge","mod_category-management","mod_category-neoforge","mod_category-utility","mod_loader-forge","mod_loader-neoforge","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-7-10","minecraft_version-1-7-2","minecraft_version-1-7-3","minecraft_version-1-7-4","minecraft_version-1-7-5","minecraft_version-1-7-6","minecraft_version-1-7-7","minecraft_version-1-7-8","minecraft_version-1-7-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n