mirror of
https://github.com/chylex/Better-Controls.git
synced 2024-11-25 01:42:45 +01:00
Compare commits
3 Commits
761fdb76da
...
9c0b3b0ac1
Author | SHA1 | Date | |
---|---|---|---|
9c0b3b0ac1 | |||
24de07cea1 | |||
380be1b547 |
@ -41,9 +41,9 @@ Both speed boosts can be configured separately for sprinting, which will be acti
|
|||||||
The following mod loaders are supported:
|
The following mod loaders are supported:
|
||||||
|
|
||||||
* **[Fabric](https://fabricmc.net/use/)** (note: this mod does not require Fabric API)
|
* **[Fabric](https://fabricmc.net/use/)** (note: this mod does not require Fabric API)
|
||||||
* **[Forge](https://files.minecraftforge.net/)**
|
* **[NeoForge](https://neoforged.net/)**
|
||||||
|
|
||||||
After you install the mod loader of your choice, [download the mod](https://www.curseforge.com/minecraft/mc-mods/better-controls/files) and place the `.jar` file into `.minecraft/mods`.
|
After you install the mod loader of your choice, download the mod from [CurseForge](https://www.curseforge.com/minecraft/mc-mods/better-controls/files) or [Modrinth](https://modrinth.com/mod/better-controls/versions) and place the `.jar` file into `.minecraft/mods`.
|
||||||
|
|
||||||
### Minecraft Updates
|
### Minecraft Updates
|
||||||
|
|
||||||
@ -63,7 +63,7 @@ While this is convenient, there is potential for bugs which can affect server pl
|
|||||||
Source Code
|
Source Code
|
||||||
===========
|
===========
|
||||||
|
|
||||||
The `main` branch includes both the Fabric and Forge version in a single project. The project uses Mojang mappings. The root project contains common source code and resource files, and the `Fabric` and `Forge` folders are subprojects with loader-specific files.
|
The `main` branch includes both the Fabric and NeoForge version in a single project. The project uses Mojang mappings. The root project contains common source code and resource files, and the `Fabric` and `NeoForge` folders are subprojects with loader-specific files.
|
||||||
|
|
||||||
The `main` branch always has the latest development version. Before updating to a new Minecraft version, a new branch is created from the `main` branch (for example, before the mod is updated to `1.18`, a branch named `1.17` will be created). Further development of older versions may continue in these branches in case backports or version-specific fixes are needed.
|
The `main` branch always has the latest development version. Before updating to a new Minecraft version, a new branch is created from the `main` branch (for example, before the mod is updated to `1.18`, a branch named `1.17` will be created). Further development of older versions may continue in these branches in case backports or version-specific fixes are needed.
|
||||||
|
|
||||||
@ -71,7 +71,7 @@ Older versions from before the merge of the Fabric and Forge versions can be fou
|
|||||||
|
|
||||||
## Contributing
|
## Contributing
|
||||||
|
|
||||||
All contributions should target the `main` branch and work in both Fabric and Forge, unless the contribution is specifically targeting older versions or a specific mod loader.
|
All contributions should target the `main` branch and work in both Fabric and NeoForge, unless the contribution is specifically targeting older versions or a specific mod loader.
|
||||||
|
|
||||||
For any larger contributions, please [open an issue](https://github.com/chylex/Better-Controls/issues/new) first before you make a PR.
|
For any larger contributions, please [open an issue](https://github.com/chylex/Better-Controls/issues/new) first before you make a PR.
|
||||||
|
|
||||||
|
56
docs/CUIRSEFORGE.md
Normal file
56
docs/CUIRSEFORGE.md
Normal file
@ -0,0 +1,56 @@
|
|||||||
|
**Better Controls** is a reimagining of [Better Sprinting](https://www.curseforge.com/minecraft/mc-mods/better-sprinting) with even more customizability. It features several new keybindings and many configurable options for how sprinting, sneaking, and flying should behave.
|
||||||
|
|
||||||
|
Better Controls only focuses on complementing vanilla mechanics, rather than adding new mechanics (such as [Better Sprinting](https://www.curseforge.com/minecraft/mc-mods/better-sprinting)'s option to allow sprinting in all directions) that only work on client side and server owners must explicitly opt in to enable them. By not having such features in Better Controls, it significantly reduces complexity by not having a server side version of the mod, and not needing a way to completely disable the mod while the game is running.
|
||||||
|
|
||||||
|
Another major difference is the amount and granularity of options. Better Controls could be considered an *advanced controls mod* - by default, none of the keybinds are bound, and all options are set to match vanilla behavior. To take full advantage, go into *Options - Controls - Better Controls*, check out all of the available options, and figure out the best configuration for you.
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
The mod adds **Toggle Keybinds** for sprinting, sneaking, flying (creative mode), walking, and jumping. You can use modifier keys (`Control` / `Shift` / `Alt`) for each, including for example setting `Control` to Sneak, and `Control + Y` to Toggle Sneak. If you press the original key, the toggle will be canceled (in the previous example, you can Toggle Sneak by pressing `Control + Y`, and stop sneaking by simply tapping Sneak). Note that the vanilla options for toggling sprinting/sneaking are disabled to avoid conflicts with the custom keybinds.
|
||||||
|
|
||||||
|
You can also bind a key that resets all **Toggle Keybinds** at once. That makes it easy to for ex. turn on walking, jumping, and sprinting, and then turn all of them off again by pressing one key instead of three.
|
||||||
|
|
||||||
|
#### Sprinting
|
||||||
|
|
||||||
|
* **Sprint Key Mode** changes how the Sprint key behaves. You can choose between *Tap To Start Sprinting*, *Tap To Start / Stop Sprinting*, and *Hold To Sprint*.
|
||||||
|
* **Double Tap 'Walk Forwards' To Sprint** can be turned off to prevent accidental sprinting.
|
||||||
|
* **Resume Sprinting After Hitting Obstacle** automatically presses the Sprint key once you are no longer touching any blocks (helpful when climbing hills, especially if the previous option is enabled).
|
||||||
|
|
||||||
|
#### Sneaking
|
||||||
|
|
||||||
|
* **Move Camera Smoothly** lets you disable the smooth movement when sneaking or unsneaking.
|
||||||
|
|
||||||
|
#### Flying
|
||||||
|
|
||||||
|
* **Double Tap 'Jump' To Fly** can be turned off to prevent accidental flight toggling.
|
||||||
|
* **Disable Flight Inertia** stops you instantly when you stop holding movement keys.
|
||||||
|
* **Disable Field Of View Changing** prevents sprinting, potions, and other factors from changing the FOV while flying in creative and spectator mode.
|
||||||
|
* **Fly On Ground** lets you fly while touching the ground in creative mode (and also lets you stop flying by tapping Sneak while touching the ground).
|
||||||
|
* **Flight Speed Multiplier** (0.25x - 8x) changes how fast you fly in creative and spectator mode.
|
||||||
|
* **Vertical Speed Boost** (up to +300%) adds additional vertical speed boost while flying in creative and spectator mode.
|
||||||
|
|
||||||
|
Both speed boosts can be configured separately for sprinting, which will be active when the Sprint key is held. Unlike in vanilla, the sprinting flight boost works in all directions.
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
The following mod loaders are supported:
|
||||||
|
|
||||||
|
* **[Fabric](https://fabricmc.net/use/)** (note: this mod does not require Fabric API)
|
||||||
|
* **[NeoForge](https://neoforged.net/)**
|
||||||
|
|
||||||
|
After you install the mod loader of your choice, [download the mod](https://www.curseforge.com/minecraft/mc-mods/better-controls/files) and place the `.jar` file into `.minecraft/mods`.
|
||||||
|
|
||||||
|
### Minecraft Updates
|
||||||
|
|
||||||
|
The mod will attempt to load on new versions of Minecraft (including snapshots) as they come out. I made it that way so that if the mod works on a newly released version of Minecraft without any changes, I can simply mark it as compatible and you don't have to wait for an update.
|
||||||
|
|
||||||
|
While this is convenient, there is potential for bugs which can affect server play. If you plan to use the mod on a server, please always use the latest version of the mod, and wait until I either mark the version as compatible with new Minecraft updates, or release a new version of the mod that is marked as compatible.
|
||||||
|
|
||||||
|
### Compatibility
|
||||||
|
|
||||||
|
* Better Controls is a client-side mod, it will do nothing when installed on a server.
|
||||||
|
* If you run into a conflict with another mod that modifies the *Controls* screen, hold Alt while opening *Controls* to prevent Better Controls from adding its button. If another mod prevents the button from appearing, a button to open the mod's configuration is available in the Mods menu (for Fabric, install [Mod Menu](https://www.curseforge.com/minecraft/mc-mods/modmenu)).
|
||||||
|
|
||||||
|
## Screenshot
|
||||||
|
|
||||||
|
![Options Menu Screenshot](https://repo.chylex.com/better-controls.png)
|
56
docs/MODRINTH.md
Normal file
56
docs/MODRINTH.md
Normal file
@ -0,0 +1,56 @@
|
|||||||
|
**Better Controls** is a reimagining of [Better Sprinting](https://modrinth.com/mod/better-sprinting) with even more customizability. It features several new keybindings and many configurable options for how sprinting, sneaking, and flying should behave.
|
||||||
|
|
||||||
|
Better Controls only focuses on complementing vanilla mechanics, rather than adding new mechanics (such as [Better Sprinting](https://modrinth.com/mod/better-sprinting)'s option to allow sprinting in all directions) that only work on client side and server owners must explicitly opt in to enable them. By not having such features in Better Controls, it significantly reduces complexity by not having a server side version of the mod, and not needing a way to completely disable the mod while the game is running.
|
||||||
|
|
||||||
|
Another major difference is the amount and granularity of options. Better Controls could be considered an *advanced controls mod* - by default, none of the keybinds are bound, and all options are set to match vanilla behavior. To take full advantage, go into *Options - Controls - Better Controls*, check out all of the available options, and figure out the best configuration for you.
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
The mod adds **Toggle Keybinds** for sprinting, sneaking, flying (creative mode), walking, and jumping. You can use modifier keys (`Control` / `Shift` / `Alt`) for each, including for example setting `Control` to Sneak, and `Control + Y` to Toggle Sneak. If you press the original key, the toggle will be canceled (in the previous example, you can Toggle Sneak by pressing `Control + Y`, and stop sneaking by simply tapping Sneak). Note that the vanilla options for toggling sprinting/sneaking are disabled to avoid conflicts with the custom keybinds.
|
||||||
|
|
||||||
|
You can also bind a key that resets all **Toggle Keybinds** at once. That makes it easy to for ex. turn on walking, jumping, and sprinting, and then turn all of them off again by pressing one key instead of three.
|
||||||
|
|
||||||
|
#### Sprinting
|
||||||
|
|
||||||
|
* **Sprint Key Mode** changes how the Sprint key behaves. You can choose between *Tap To Start Sprinting*, *Tap To Start / Stop Sprinting*, and *Hold To Sprint*.
|
||||||
|
* **Double Tap 'Walk Forwards' To Sprint** can be turned off to prevent accidental sprinting.
|
||||||
|
* **Resume Sprinting After Hitting Obstacle** automatically presses the Sprint key once you are no longer touching any blocks (helpful when climbing hills, especially if the previous option is enabled).
|
||||||
|
|
||||||
|
#### Sneaking
|
||||||
|
|
||||||
|
* **Move Camera Smoothly** lets you disable the smooth movement when sneaking or unsneaking.
|
||||||
|
|
||||||
|
#### Flying
|
||||||
|
|
||||||
|
* **Double Tap 'Jump' To Fly** can be turned off to prevent accidental flight toggling.
|
||||||
|
* **Disable Flight Inertia** stops you instantly when you stop holding movement keys.
|
||||||
|
* **Disable Field Of View Changing** prevents sprinting, potions, and other factors from changing the FOV while flying in creative and spectator mode.
|
||||||
|
* **Fly On Ground** lets you fly while touching the ground in creative mode (and also lets you stop flying by tapping Sneak while touching the ground).
|
||||||
|
* **Flight Speed Multiplier** (0.25x - 8x) changes how fast you fly in creative and spectator mode.
|
||||||
|
* **Vertical Speed Boost** (up to +300%) adds additional vertical speed boost while flying in creative and spectator mode.
|
||||||
|
|
||||||
|
Both speed boosts can be configured separately for sprinting, which will be active when the Sprint key is held. Unlike in vanilla, the sprinting flight boost works in all directions.
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
The following mod loaders are supported:
|
||||||
|
|
||||||
|
* **[Fabric](https://fabricmc.net/use/)** (note: this mod does not require Fabric API)
|
||||||
|
* **[NeoForge](https://neoforged.net/)**
|
||||||
|
|
||||||
|
After you install the mod loader of your choice, [download the mod](https://modrinth.com/mod/better-controls/versions) and place the `.jar` file into `.minecraft/mods`.
|
||||||
|
|
||||||
|
### Minecraft Updates
|
||||||
|
|
||||||
|
The mod will attempt to load on new versions of Minecraft (including snapshots) as they come out. I made it that way so that if the mod works on a newly released version of Minecraft without any changes, I can simply mark it as compatible and you don't have to wait for an update.
|
||||||
|
|
||||||
|
While this is convenient, there is potential for bugs which can affect server play. If you plan to use the mod on a server, please always use the latest version of the mod, and wait until I either mark the version as compatible with new Minecraft updates, or release a new version of the mod that is marked as compatible.
|
||||||
|
|
||||||
|
### Compatibility
|
||||||
|
|
||||||
|
* Better Controls is a client-side mod, it will do nothing when installed on a server.
|
||||||
|
* If you run into a conflict with another mod that modifies the *Controls* screen, hold Alt while opening *Controls* to prevent Better Controls from adding its button. If another mod prevents the button from appearing, a button to open the mod's configuration is available in the Mods menu (for Fabric, install [Mod Menu](https://modrinth.com/mod/modmenu)).
|
||||||
|
|
||||||
|
## Screenshot
|
||||||
|
|
||||||
|
![Options Menu Screenshot](https://cdn.modrinth.com/data/ANpj0aBF/images/9fed66f9f60a8d880fba24f5333ed7e11d1a7ae2.png)
|
@ -3,7 +3,7 @@ modId=bettercontrols
|
|||||||
modName=Better Controls
|
modName=Better Controls
|
||||||
modDescription=Adds many powerful key bindings and options to control your movement.\\n\\nThe features complement vanilla mechanics without giving unfair advantages, so server use should be fine.
|
modDescription=Adds many powerful key bindings and options to control your movement.\\n\\nThe features complement vanilla mechanics without giving unfair advantages, so server use should be fine.
|
||||||
modAuthor=chylex
|
modAuthor=chylex
|
||||||
modVersion=1.3.1
|
modVersion=1.4.0
|
||||||
modLicense=MPL-2.0
|
modLicense=MPL-2.0
|
||||||
modSourcesURL=https://github.com/chylex/Better-Controls
|
modSourcesURL=https://github.com/chylex/Better-Controls
|
||||||
modIssuesURL=https://github.com/chylex/Better-Controls/issues
|
modIssuesURL=https://github.com/chylex/Better-Controls/issues
|
||||||
|
Loading…
Reference in New Issue
Block a user