跳到正文
返回搜尋

Lepton

作者 MiracleForest

Small vanilla+ improvements for Minecraft Bedrock Edition, each one a module you can turn off

0.1.0

README0.1.0

Lepton

Build License: CC BY-NC-SA 4.0

Lots of small things that make vanilla better, each one a module you can turn off. Lepton is a LeviLamina mod for Minecraft Bedrock Edition, for dedicated servers and single-player worlds.

Features

docs/SPEC.md has the details of every module and the features that are not on Bedrock.

  • Automation: chains that pull blocks along, iron rods, piston rules, gravisand, metal buttons, the obsidian pressure plate, the redstone randomizer, the ender watcher, block-placing dispensers, chutes and feeding troughs.
  • Building: vertical slabs, stone and brick variants, palette blocks (shingles, framed glass, gold bars, industrial and Japanese palettes, thatch, grates), wood variants (vertical planks, bookshelves, ladders, posts, hedges, leaf carpets, hollow logs), compressed blocks, stools, rope, variant chests and furnaces, crystal lamps and glass item frames.
  • Management: inventory sorting, easy transferring, chest searching, the hotbar changer, tool restock, quick armour swapping, expanded item interactions and item sharing.
  • Tools: pickarangs, torch arrows, parrot eggs, skull pikes, bottled clouds, slime in a bucket, ancient tomes, colour runes, beacon redirection, the abacus, pathfinder maps, ambience discs, the trowel and the seed pouch.
  • Oddities: matrix enchanting, the backpack, the Totem of Holding, copper pipes, crates, magnets and the tiny potato.
  • Mobs: crabs, shibas, oretoises, stonelings, the Forgotten, foxhounds and wraiths.
  • Tweaks: simple harvesting, hoe harvesting, reacharound placing, rotation lock, enhanced ladders, emotes, patting the dogs, double doors, better sponges, utility recipes, map washing, dyeable item frames and many smaller ones.
  • World: the azalea, trumpet and ashen woods, new stones and permafrost, big stone clusters, corundum, fairy rings, fallen logs, monster boxes, the Glimmering Weald, Nether obsidian spikes, chorus vegetation and spiral spires.
  • Client (needs the client mod): usage ticker, elytra indicator, improved tooltips, auto-walk, back button, long-range pick block, greener grass, variant animal skins, bucket icons and camera mode.

Players on a Lepton server don't need the client mod: the server sends its resource pack, and features with a screen fall back to forms, vanilla container screens or the /lepton commands below. HUD, tooltip and keybind features need the client mod.

Install

You need Minecraft Bedrock Edition for Windows (x64) with LeviLamina (on a client, installed through LeviLauncher). A Lepton release is built against each LeviLamina line it supports, and you pick the one that matches your game:

MinecraftLeviLaminaVariant
1.26.6026.60.x26_60, and the default
1.26.5126.51.x26_51

In LeviLauncher, install Lepton from the LeviMC Mods page; it offers the variants above, and the default is the newest line.

With lip 0.40.0 or later, on a dedicated server or a client (lip picks the build of the side it installs to):

lip install github.com/MiracleForest/Lepton          # the newest line (26.60)
lip install github.com/MiracleForest/Lepton#26_51    # Minecraft 1.26.51

lip installs only one variant of Lepton at a time. To switch an installed Lepton to another line, uninstall it first (lip uninstall github.com/MiracleForest/Lepton, with the variant it was installed as, such as #26_51), then install the other variant. Your settings in the config folder are kept.

Or download the ZIP for your line and side from the releases page (pre-releases such as betas are listed there too, but not under "Latest") and extract it into a Lepton folder, so that Lepton/manifest.json exists:

WhereZIPFolder
Dedicated server, 1.26.60lepton-server-win-x64-ll26.60.zipmods/Lepton/
Client (LeviLauncher), 1.26.60lepton-client-win-x64-ll26.60.zipmods/Lepton/
Dedicated server, 1.26.51lepton-server-win-x64-ll26.51.zipplugins/Lepton/
Client (LeviLauncher), 1.26.51lepton-client-win-x64-ll26.51.zipmods/Lepton/

Commands

CommandWhoWhat it does
/lepton reloadOperators, consoleReloads the configuration and translations.
/lepton sort [container]EveryoneSorts your inventory, or the container you look at.
/lepton transfer insert|extract [filtered]EveryoneMoves items into or out of the container you look at.
/lepton hotbar [1-3]EveryoneSwaps the hotbar with an inventory row (a form without a row).
/lepton shulkerEveryoneOpens the shulker box in your main hand.
/lepton shareEveryoneShares the item in your main hand in chat.
/lepton emote [name]EveryonePlays an emote (wave, custom:<file>, ...); a form without a name.
/lepton lockrotation [clear]EveryoneRotation lock for players without the client mod.
/lepton variant [name|original]EveryoneVariant selector form, or picks a variant directly (VariantSelector enabled).
/lepton crystals infoEveryoneHints about corundum, crystal lamps, beacon redirection and magnets.
/lepton crystals magneticEveryoneTells whether the item in your hand is magnetic.
/lepton newstones infoEveryoneHints about the new stones and permafrost.
/lepton newstones sources [radius]OperatorsLists the stone cluster sources near you.
/lepton locate glimmering_weald|monster_boxOperatorsFinds the nearest Glimmering Weald or known monster box.
/lepton worldgen statsOperatorsCounts the features generated since the start.
/lepton enchanting tome <enchantment>OperatorsGives an ancient tome.
/lepton enchanting rune <colour>OperatorsApplies a rune colour to the enchanted item in your hand.
/lepton enchanting demo [anvil|smithing|fill]OperatorsTest helpers for matrix enchanting, tomes and runes.
/lepton gadgets quill <biome>OperatorsGives a Pathfinder's Quill for a biome.
/lepton gadgets potato angry|name <name>OperatorsTiny potato test helpers.
/lepton seedpouch <item>OperatorsGives a full seed pouch.
/lepton cosmetics gallery|view <row>|buckets|pumpkin <cursed>|carryOperatorsCosmetics previews.
/lepton debug backpack|totem|hud|form|containerOperatorsTest helpers (fill the backpack, spawn a totem, tooltip test kit, test form, test container).
/lepton net [ping]Operators, consoleLists who runs the client mod; pings the client mods.
/lepton selftest ["glob"]Operators, consoleRuns the in-game selftests.

Configuration

Settings live in config/*.json inside the mod folder (mods/Lepton/, or plugins/Lepton/ on a 1.26.51 server). Each file is created with defaults on first start, and /lepton reload applies changes (content and world generation changes apply when a world loads). A unit's file has one enable<Module> switch per module plus that module's options: docs/SPEC.md §5 lists every key and its default.

FileContents
mod.jsonLepton itself: language (en_US; server messages when a player's own language has no translation), usePlayerLocale (true), requireResourcePack (true; dedicated server: players must accept the resource pack).
keybinds.jsonClient: the keys of Lepton's keybinds (also in the game's Controls settings).
vslabs.jsonVerticalSlabs, SlabsToBlocks
stones.jsonMoreStoneVariants, RawMetalBricks, SturdyStone, CelebratoryLamps
newstones.jsonNewStoneTypes, Permafrost, BigStoneClusters, VanillaStoneClusters
bricks.jsonMoreBrickTypes, SoulSandstone, MoreMudBlocks, Midori, DuskboundBlocks
palette.jsonShingles, FramedGlass, GoldBars, IndustrialPalette, JapanesePalette, NetherBrickFenceGate, Thatch, Grate
woodvariants.jsonVerticalPlanks, VariantBookshelves, VariantLadders, WoodenPosts, Hedges, LeafCarpet, HollowLogs
newwoods.jsonAzaleaWood, AncientWood, BlossomTrees
storage.jsonCompressedBlocks, Stools, Rope, ShearVines, MorePottedPlants, GlassShard, UtilityRecipes
variantcontainers.jsonVariantChests, VariantFurnaces
redstone.jsonChainsConnectBlocks, IronRod, PistonsMoveTileEntities (with pistonPushLimit), Gravisand, MetalButtons, ObsidianPlate, RedstoneRandomizer, EnderWatcher, DispensersPlaceBlocks
logistics.jsonChute, Pipes, FeedingTrough, Crate
crystals.jsonCorundum, RainbowLamps, BeaconRedirection, Magnets
enchanting.jsonMatrixEnchanting, AncientTomes, ColorRunes
backpack.jsonBackpack, TotemOfHolding, SeedPouch
inventory.jsonInventorySorting, EasyTransferring, ChestSearching, HotbarChanger, AutomaticToolRestock, QuickArmorSwapping, ExpandedItemInteractions, ItemSharing
hud.jsonUsageTicker, ElytraIndicator, ImprovedTooltips, AutoWalkKeybind, BackButtonKeybind
placement.jsonReacharoundPlacing, LockRotation, VariantSelector, Trowel, ReplaceScaffolding, LongRangePickBlock, EnhancedLadders
cosmetics.jsonGreenerGrass, VariantAnimalTextures, BucketsShowInhabitants, SoulCandles, WoolShutsUpMinecarts, UsesForCurses, MoreVillagers, Camera
emotes.jsonEmotes, PatTheDogs (custom emotes go in config/lepton_emotes/)
mobsoverworld.jsonCrabs, Shiba, Toretoise
mobsdeep.jsonStonelings, Forgotten, Foxhound, Wraith
throwables.jsonPickarang, TorchArrow, ParrotEggs, SkullPikes, BottledCloud, SlimeInABucket
gadgets.jsonAbacus, PathfinderMaps, AmbientDiscs, EndermoshMusicDisc, CompassesWorkEverywhere, TinyPotato
frames.jsonGlassItemFrame, DyeableItemFrames, MoreBannerLayers, MapWashing
farming.jsonSimpleHarvest, HoeHarvesting, PigLitters, PoisonPotatoUsage, CoralOnCactus, RenewableSporeBlossoms, PetalsOnWater, GrabChickens, HorsesSwim, VillagersFollowEmeralds
mobtweaks.jsonSaferCreatures, SlimesToMagmaCubes, SnowGolemPlayerHeads, VexesDieWithTheirMasters, ZombieVillagersOnNormal, DragonScales, GoldToolsHaveFortune, DiamondRepair, NoDurabilityOnCosmetics, ShulkerPacking, MagmaKeepsConcretePowder, ImprovedSponges, DoubleDoorOpening
misctweaks.jsonBetterElytraRocket, CampfiresBoostElytra, MoreNoteBlockSounds, AutomaticRecipeUnlock, ArmedArmorStands, GameNerfs, SpawnerReplacer, VillagerRerollingRework, AdjustableChat, NarratorReadout, ClimateControlRemover (the OverlayShader and MicrocraftingHelper keys are kept but do nothing on Bedrock)
worldsurface.jsonFairyRings, FallenLogs, MonsterBox, GlimmeringWeald, CherryGroveWaterPetals
worldbeyond.jsonNetherObsidianSpikes, NoMoreLavaPockets, ChorusVegetation, SpiralSpires

Keybinds (client mod)

Default keyAction
HHotbar changer (not Z, which is Bedrock's Mob Effects key)
KRotation lock
R (hold)Variant selector (experimental, VariantSelector enabled)
F12Camera mode
Shift + T over a slotShare the item (the chat key, in inventory screens)
Mouse button 5Back (backMouseButton in hud.json)
Not boundSorting, insert, extract, shift lock, auto-walk, narrator readout, each emote

Change them in the game's Controls settings or in config/keybinds.json.

Contributing

See CONTRIBUTING.md. AGENTS.md is the developer guide.

License

CC BY-NC-SA 4.0 (Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International). Lepton may not be sold or distributed for profit, including behind a paywall or on ad-supported download pages. See NOTICE for third-party notices.

安裝 Lepton

執行端
  • 伺服器端
  • 用戶端
平台
  • win-x64

在伺服器目錄中用 lip 執行:

lip install github.com/MiracleForest/Lepton@0.1.0

在用戶端上,請透過以下方式安裝: LeviLauncher

從 GitHub 下載