Titanium is 1.8.8 Paper fork which aims to improve performance, fix exploits and bugs, improve API and provide better configuration for server administrators.
Titanium officially supports JDK 8, 11 & 17 - but we recommend to use Java 17.
Latest version of Titanium - Releases page.
Dev versions (less stable, but with newer patches) - Jenkins
If you want to build Titanium you will need these things to be installed and available from your shell:
To patching, compiling and building Titanium you will use titanium script.
To just build Titanium clone this repository and run ./titanium build paperclip in the root directory. Then you will find your server jar in Titanium-Server/build/libs, it should be named titanium.jar.
Repository:
<repository>
<id>titanvale-snapshots</id>
<url>https://repo.titanvale.net/snapshots/</url>
</repository>API:
<dependency>
<groupId>net.titanvale</groupId>
<artifactId>titanium-api</artifactId>
<version>1.8.8-R0.1-SNAPSHOT</version>
<scope>provided</scope>
</dependency>Server:
<dependency>
<groupId>net.titanvale</groupId>
<artifactId>titanium-server</artifactId>
<version>1.8.8-R0.1-SNAPSHOT</version>
<scope>provided</scope>
</dependency>Titanium implements patches from other engines as well. All credits go to the people who created them.
[Spigot-0138] Branchless NibbleArray by md5
[Spigot-2380] Hitting in the air will always load the chunk at 0,0 by md_5
[Spigot-5294] Cancelled EntityPickupItemEvent and PlayerPickupItemEvent alter on-ground stacks by md_5
[Spigot-5428] Better handling of some ItemMeta by Mathias
[Paper-0009] Version Command 2.0 by Zach Brown
[Paper-0008/0013] Add command line option to load extra plugin jars not in the plugins folder by Jason Penilla
[Paper-0019] Implement Paper VersionChecker by Zach Brown
[Paper-0022] Further improve server tick loop by Aikar
[Paper-0044] Use UserCache for player heads
[Paper-0072] Fix Furnace cook time bug when lagging by Aikar
[Paper-0072] Only process BlockPhysicsEvent if a plugin has a listener by Aikar
[Paper-0076] Optimized light level comaprsions by Aikar
[Paper-0077] Add World Util Methods by Aikar
[Paper-0085] Use a Shared Random for Entities
[Paper-0090] Improve Maps (in item frames) performance and bug fixes by Aikar
[Paper-0101] Do not load chunks for light check by Aikar
[Paper-0116] Fix Bugs with Spigot Mob Spawn Logic by Aikar
[Paper-0118] Prevent Fire from loading chunks by Aikar
[Paper-0121] Reduce IO ops opening a new region
[Paper-0127] Do not load chunks for pathfinding by Aikar
[Paper-0135] Avoid blocking on Network Manager creation by Aikar
[Paper-0137] Faster redstone torch rapid clock removal by Martin Panzer
[Paper-0144] Improve Minecraft Hopper Performance
[Paper-0156] Auto Save Improvements by Aikar
[Paper-0161] Disable Vanilla Chunk GC by Aikar
[Paper-0168] Disable ticking of snow blocks
[Paper-0168] Cache user authenticator threads by vemacs
[Paper-0173] Optimize World.isLoaded(BlockPosition)
[Paper-0175] Don't let fishinghooks use portals by Zach Brown
[Paper-0180] Server Tick Events
[Paper-0186] Prevent Pathfinding out of World Border by Aikar
[Paper-0192] Make legacy ping handler more reliable by Minecrell
[Paper-0201] Remove CraftScheduler Async Task Debugger by Aikar
[Paper-0202] Shame on you Mojang moves chunk loading off https thread
[Paper-0210] Use TerminalConsoleAppender for console improvements by Minecrell
[Paper-0232] Fix MC-117075: TE Unload Lag Spike by mezz
[Paper-0276] Improved Async Task Scheduler by Aikar
[Paper-0088/0277] Ability to change PlayerProfile in AsyncPreLoginEvent by Aikar
[Paper-0287] MC-124833 by Zach Brown
[Paper-0302] Don't load chunks for villager door check by Aikar
[Paper-0313] Optimized world time updates by Aikar
[Paper-0321] Cleanup allocated favicon ByteBuf
[Paper-0328] Optimize Network Manager and add advanced packet support by Aikar
[Paper-0332] Add More information to Entity.toString() by Aikar
[Paper-0342] Always process chunk removal in removeEntity by Aikar 2018
[Paper-0344] [MC-111480] Start Entity ID's at 1
[Paper-0346] [MC-135506] Experience should save as Integers
[Paper-0347] Don't go below 0 for pickupDelay, breaks picking up items by Aikar
[Paper-0348] Prevent chunk loading from Fluid Flowing by Aikar
[Paper-0350] Use a Queue for Queueing Commands
[Paper-0352] Optimize BlockPosition helper methods by Spottedleaf
[Paper-0353] Send nearby packets from world player list not server by Mystiflow
[Paper-0361] Async Chunk Loading and Generation by Aikar
[Paper-0362] Prevent mob spawning from loading/generating chunks by Shane Freeder
[Paper-0369] Prevent rayTrace from loading chunks by Aikar
[Paper-0374] Add Stricter Client Sign limits by Aikar
[Paper-0378] Performance improvement for Chunk.getEntities by wea_ondara
[Paper-0387] Reduce memory footprint of NBTTagCompound by Spottedleaf
[Paper-0206/0432] Add Raw Byte ItemStack Serialization by Mariell Hoversholm
[Paper-0451] Load Chunks for Login Asynchronously by Aikar
[Paper-0242/0614] Player Chunk Load/Unload Events by ysl3000
[Paper-0740] Add Unix domain socket support by Andrew Steinborn
[Paper-0797] Use Velocity compression and cipher natives by Elier
[Taco-0006] Fix hopper lag by making entities look for hoppers by Techcable
[Taco-0010] Optimize armor stands by Techcable
[Taco-0011] Add a flag to disable InventoryMoveItemEvent by Techcable
[Taco-0013] Option to disable Scoreboard for non players by Aikar
[Taco-0014] Add an option for grass to ignore light by Techcable
[Taco-0017] Add option to stop redstone firing BlockPhysicsEvent by frash23
[Taco-0024] Optimize tnt entity and falling block movement
[Taco-0025] Fix east west cannoning
[SportPaper-0027] Fix head rotation packet spam
[SportPaper-0031/0058] Potion effect events by cswhite2000
[SportPaper-0162] Fix PlayerInteractEvent not cancelling properly by cswhite2000
[SportPaper-0176] Use fast util collections
[SportPaper-0185] Speed up chunk unloading
[SportPaper-0198] Optimize head rotation patch
[SportPaper-0204] Fix Teleport Invisibility
[SportPaper-0207] Optimize toLegacyData removing sanity checks by Pablete1234
[FlamePaper-0003] Fix chunk memory leak
[FlamePaper-0005] Fix multiple memory leaks
[FlamePaper-0010] Fix NullPointerException exploits for invalid logins
[FlamePaper-0013] Check channel before reading
[FlamePaper-0015] Fix Book Exploits
[FlamePaper-0017] Pearl through blocks
[FlamePaper-0024] Disable Unloaded Chunk Movement
[FlamePaper-0030] Adaptive chunk GC
[FlamePaper-0032] Dont load chunks for chests
[FlamePaper-0033] Dont check occluding hoppers by LinsaFTW
[FlamePaper-0034] Hopper item lookup optimization by LinsaFTW
[Nacho-0009] Remove an extra file io call within world credit bob7l
[Nacho-0010] Use jchambers' FAST UUID methods
[Nacho-0012] Don't load chunks for physics
[Nacho-0023] Optimize EntityTracker for the chunk updater
[Nacho-0024] Do not create new BlockPosition when loading chunk
[Nacho-0025] Disable random tickSpeed being modified
[Nacho-0027] Netty IP_TOS 0x18 by Health Logan Campbell
[Nacho-0050] Custom knockback
[Nacho-????] Prevent most NBT related overflow exploits
[Nacho-????] Async TNT by Sculas
[Nacho-????] Async Entity Tracker by Rastrian
[Nacho-????] Async knockback and hit detection packets by Rastrian
[WindSpigot-0014] Async entity path searching by windcolor-dev
[WindSpigot-0017] Async entity tracking by windcolor-dev
[WindSpigot-0054] Modern tick loop by windcolor-dev
[PandaSpigot-0003/0004] Setup Gradle project by hpfxd
[PandaSpigot-0005] Add internal setMaxStackSize method for materials by hpfxd
[PandaSpigot-0004/0005] Backport PlayerHandshakeEvent from Paper by hpfxd
[PandaSpigot-0006] Update to Netty 4.1.x by hpfxd
[PandaSpigot-0008] Remove hacky stackable buckets code by hpfxd
[PandaSpigot-0009] Improved plugins command by hpfxd
[PandaSpigot-0033] Configurable arrow trajectory by hpfxd
[PandaSpigot-0010/0037] Backport PlayerProfile API by hpfxd
[PandaSpigot-0039] Optimize VarInt reading and writing by hpfxd
[PandaSpigot-0040] Various micro-optimizations for PacketDataSerializer by hpfxd
[PandaSpigpt-0049] Add setting for proxy online mode status by hpfxd
[PandaSpigot-0050] Metrics by hpfxd
[PandaSpigot-0054] Disconnect for payload errors by uRyanxD
[PandaSpigot-0060] Optimise removeQueue by hpfxd
[IonSpigot-0003] Explosion Improvements by SuicidalKids
[IonSpigot-0006] Fix Chunk Loading by SuicidalKids
[IonSpigot-0008] Reduce Chunk Hashing by SuicidalKids
[IonSpigot-0009] Reduce Unload Queue Complexity by SuicidalKids
[IonSpigot-0013] Implement PandaWire by SuicidalKids
[IonSpigot-0014] Faster Chunk Entity List by SuicidalKids
[IonSpigot-0020] Faster EntityTracker Collections by SuicidalKids
[IonSpigot-0037] Fast Cannon Entity Tracker by SuicidalKids
[Migot-0005] Fix Occasional Client Side Unloading of Chunk 0 0
[Migot-0007] Optimize Idle Furnaces by Poweruser
[Migot-0009] Prevent creature spawning in unloaded chunks
[Migot-0027] Enable Concurrent Chunk Decoration
[Migot-0032] Thread Local IntCache
[Migot-0036] Check for lava only once per tick
[KigPaper-0108] Fix CraftPlayer setFlying not working by RoccoDev
[KigPaper-0110] Backport from Spigot: Enforce cooldowns on book edits by RoccoDev
[KigPaper-0112] Only trigger PlayerConnection#disconnect once by RoccoDev
[KigPaper-0138] Fix some more memory leaks by RoccoDev
[KigPaper-0161] Fix CraftingManager memory leak by RoccoDev
[KigPaper-0170] Kick after receiving invalid creative action packet by RoccoDev
[Purpur-0150] Tick fluids config
[Purpur-0046/0280] Spark Profiler by BillyGalbreath
[Purpur-0049/0290] Remove Timings by BillyGalbreath
[Purpur-0291] Remove Mojang Profiler by BillyGalbreath
[Tuinity-0008] Allow controlled flushing for network manager by Spottedleaf
[Tuinity-0046] Consolidate flush calls for entity tracker packets by Spottedleaf
[Tuinity-0051] Optimise non-flush packet sending by Spottedleaf
[Yatopia-0030] Don't save Fireworks and Arrows by tr7zw
[Yatopia-0047] Smarter statistics ticking
[Akarin-0007] Avoid double I/O operation on load player file
[InsanePaper-269] Cache Chunk Coordinations
[Lithium-ai/pathing/ChunkCache] Micro optimization for ChunkCache
[PaperBin-????] Optimise WorldServer#everyoneDeeplySleeping
[PaperBin-????] Faster Game Rules Lookup
- To start contributing to Titanium, make sure you meet the Requirements. Then you can run
./titanium buildto prepare upstream and apply patches. - To add patches to Titanium simply make your changes in
Titanium-APIandTitanium-Server, then just commit them. Then run./titanium rebuild. - After modifying code to for eg. test it, run
./titanium jar.