Skip to content

Commit 6f92dff

Browse files
committed
Merge branch 'refs/heads/main' into release/1.20.1
# Conflicts: # COMPAT.md # common/src/main/resources/assets/miapi/lang/en_us.json
2 parents 516bd92 + 535ca63 commit 6f92dff

File tree

2 files changed

+60
-42
lines changed

2 files changed

+60
-42
lines changed

COMPAT.md

+25-27
Original file line numberDiff line numberDiff line change
@@ -1,33 +1,31 @@
1-
# Compat information
2-
## Dedicated Compat
3-
These Mods have received dedicated compatibility patches/bugfixes in truly modular to ensure compatibility
4-
This IS NOT a definitive list of compatible mods, just a list of mods that originally caused issues that we fixed.
5-
- **Better Combat**:
6-
dedicated and integrated support
7-
But Better Combat sadly has a bug with NBT based Compat. We recommend using https://modrinth.com/mod/better-combat-nbt-fix for multiplayer
8-
- **Epic Fight**: weapons are mostly supported, armor sadly is not
9-
- **Apoli**: is Origins power api, we have support via a property, allowing developers to use any apolipowers on modular items
10-
- **HT Treechop**: If HT Treechop is loaded, woodcutting axes and normal axes will synergies with it
11-
- **Project MMO**: light weight support so modular items are somewhat picked up by it.
12-
- **Quark**: Quarks Enchanting Glint is somewhat supported on modular items
13-
- **Apotheosis/Zenith**: Minor bugfixes for certain colliding effects
1+
# Compatibility information
2+
3+
## Dedicated Compatibility
4+
- **[Better Combat](https://modrinth.com/mod/better-combat)** has dedicated and integrated support within MIAPI.
5+
That being said, Better Combat also sadly has a bug with NBT based compatibility. We recommend using **[Better Combat NBT Fix](https://modrinth.com/mod/better-combat-nbt-fix)** for multiplayer.
6+
- **[Epic Fight](https://modrinth.com/mod/epic-fight)** should be fully supported well. If somebody wants to add more depth to the choices for EF, feel free to share with us.
7+
- **[Apoli](https://github.com/apace100/origins-fabric?tab=readme-ov-file)** is the Origins power API. We have support via a property, allowing developers to use any Apoli powers on modular items.
8+
- **[Quark](https://modrinth.com/mod/quark)** has special enchantment glint effects, and these are supported.
9+
- **[Apotheosis](https://www.curseforge.com/minecraft/mc-mods/apotheosis)**, and its Fabric port **[Zenith](https://modrinth.com/mod/zenith)** adds Affixes to equipment, and these are supported
10+
11+
## Other Mod Info
12+
- **[Better Paragliders](https://modrinth.com/mod/better-paragliders)** stamina system should work with MIAPI tools.
1413

1514
## Generated Material Info
16-
Truly Modular attempts to make any mods Tool Materials compatible.
17-
This is done by scanning a Mods tools and trying to match their stats.
18-
Most mods should work with this system.vs
15+
Truly Modular attempts to make any mods' tool materials compatible.
16+
This is done by scanning a mod's tools, and trying to match their stats.
17+
Most mods should work with this system.
1918
- **Reqirements**
20-
A Sword and an Axe implement as the same Toolfamily.
19+
Swords and Axes need to implement as the same tool family.
2120
- **Exceptions**
22-
Some mods sadly implement their Tools differently/weirdly and dont get detected because of that.
23-
In addition right click abilities and on-hit effects or similar effects cant be automaticly detected sadly
24-
- **Quirks**
25-
Sometimes the texturing or Naming of the Generated Material may be odd, this is simply due to the generative nature.
26-
27-
## Make your own Compat
28-
29-
If some compat is still missing you can try to your own hand at it with the [Material Helper](https://truly-modular.github.io/Material-Helper/)
30-
This is a Website that lets anybody make compat materials for Truly Modular, even without any coding knowledge.
21+
Some mods sadly implement their tools differently or weirdly, and don't get detected because of that.
22+
In addition, right click abilities, on-hit effects, or similar effects can't be automatically detected.
23+
- **Quirks**
24+
Sometimes the texturing or naming of the generated material may be odd, this is simply due to the generative nature.
25+
26+
## Make Your Own Compatibility
27+
If some compatibility is still missing, you can try your own hand at it with the **[Truly Modular Material Helper](https://truly-modular.github.io/Material-Helper/)**.
28+
This is a web app that lets anybody make compat materials for Truly Modular, even without any coding knowledge.
3129

3230
## Issues
33-
if you encounter any issues be sure to report them https://github.com/Truly-Modular/Modular-Item-API/issues
31+
If you encounter any issues, be sure to report them to https://github.com/Truly-Modular/Modular-Item-API/issues

README.md

+35-15
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,36 @@
1-
The Truly Modular: miapi (Modular Item API) includes a comprehensive set of APIs, offering a wide range of features and functionalities to modders. Some of the key APIs provided by miapi include:
1+
<img src="common/src/main/resources/icon.png" alt="totally modular api icon" width="256">
22

3-
- Complex Module Properties: A complex Property resolving system producing predictable and easily adjustable results for Addon devs
3+
# Modular-Item-API
4+
[![](http://cf.way2muchnoise.eu/versions/904056.svg)](https://www.curseforge.com/minecraft/mc-mods/modular-item-api)
5+
[![Modrinth](https://img.shields.io/modrinth/v/c4Uf1TKc?label=Modrinth&labelColor=%232D2D2D)](https://modrinth.com/mod/modular-item-api)
46

5-
- Runtime Property Injections and Overrides: Seamlessly inject or override properties at runtime using the Property system to inject additional Properties to a singular Module ona singular Item.
7+
Truly Modular: miapi (Modular Item API) includes a comprehensive set of APIs, offering a wide range of features and functionalities to modders. Some of the key APIs provided by miapi include:
68

7-
- GUI APIs: Access various GUI APIs to create GUIs with proper order of hirarchy and children logic to allow the creation of Complex GUIs.
9+
- Complex Module Properties: A complex Property resolving system producing predictable and easily adjustable results for Addon devs.
10+
11+
- Runtime Property Injections and Overrides: Seamlessly inject or override properties at runtime using the Property system to inject additional Properties to a singular Module on a singular Item.
12+
13+
- GUI APIs: Access various GUI APIs to create GUIs with proper order of hierarchy and children logic, to allow the creation of Complex GUIs.
814

915
- Modular Item Crafter GUI: Enjoy a fully functional modular item crafter GUI, providing players with a convenient way to craft and assemble their customized modular items.
1016

11-
- Synergy System between Modules: With a complex Synergysystem allowing unique Synergies between modules or materials allowing to target groups of each to create intricate Synergies.
17+
- Synergy System between Modules: With a complex Synergy system allowing unique Synergies between modules or materials allowing to target groups of each to create intricate Synergies.
1218

1319
- Dozens of Default Properties: Benefit from a wide range of default properties that come bundled with miapi, saving you time and effort in defining common item attributes to be used accross addons.
1420

15-
- Dozens of Default Materials: Utilize a diverse selection of default materials available within miapi from vanilla in addition to wide ranging mod support.
21+
- Dozens of Default Materials: Utilize a diverse selection of default materials available within miapi from vanilla, in addition to wide ranging mod support.
1622

17-
- Complex 3D Capabilities: By abstracting the rendering any kind of effect can be implemented, by default this is mostly limited to block/item models for modules; entities and other special options do exist as well
23+
- Complex 3D Capabilities: By abstracting the rendering, any kind of effect can be implemented, by default this is mostly limited to block/item models for modules; entities and other special options do exist as well
1824

19-
And much more awaits you as you delve into the world of Truly Modular: miapi. Explore the limitless potential of modular item customization and elevate your modding projects to new heights.
25+
Much more awaits you as you delve into the world of Truly Modular: miapi. Explore the limitless potential of modular item customization and elevate your modding projects to new heights.
2026

2127
# For Developers
22-
latest version can be checked https://github.com/Truly-Modular/Modular-Item-API/releases
23-
We recommend the usage of any Architectury Template, depending on Architectury is also recommended since Truly Modular already depends on it
24-
the miapi_version needed is the same as the github release tag
25-
## Common
28+
The latest version can be checked here: https://github.com/Truly-Modular/Modular-Item-API/releases
29+
We recommend the usage of any Architectury Template, and depending on Architectury is also recommended since Truly Modular already depends on it.
30+
31+
The miapi_version needed is the same as the Github release tag.
32+
## Repositories
33+
Add this to every subproject.
2634
```js
2735
repositories {
2836
maven {
@@ -38,22 +46,34 @@ repositories {
3846
includeGroup "com.jamieswhiteshirt"
3947
}
4048
}
49+
maven {
50+
name = 'GeckoLib'
51+
url 'https://dl.cloudsmith.io/public/geckolib3/geckolib/maven/'
52+
content {
53+
includeGroupByRegex("software\\.bernie.*")
54+
includeGroup("com.eliotlash.mclib")
55+
}
56+
}
4157
}
4258
```
59+
## Common
4360
```js
4461
dependencies {
45-
modApi("com.Truly-Modular.Modular-Item-API:Truly-Modular-miapi-common:${rootProject.miapi_version}")
62+
modApi("com.Truly-Modular.Modular-Item-API:Truly-Modular-miapi-common:${rootProject.miapi_version}-${rootProject.minecraft_version}")
4663
}
4764
```
4865
## Fabric
4966
```js
5067
dependencies {
51-
modApi("com.Truly-Modular.Modular-Item-API:Truly-Modular-miapi-fabric:${rootProject.miapi_version}")
68+
modApi("com.Truly-Modular.Modular-Item-API:Truly-Modular-miapi-fabric:${rootProject.miapi_version}-${rootProject.minecraft_version}")
5269
}
5370
```
5471
## Forge
5572
```js
5673
dependencies {
57-
modApi("com.Truly-Modular.Modular-Item-API:Truly-Modular-miapi-forge:${rootProject.miapi_version}")
74+
compileOnly(annotationProcessor("io.github.llamalad7:mixinextras-common:0.4.1"))
75+
implementation(include("io.github.llamalad7:mixinextras-forge:0.4.1"))
76+
modApi("com.Truly-Modular.Modular-Item-API:Truly-Modular-miapi-forge:${rootProject.miapi_version}-${rootProject.minecraft_version}")
77+
forgeRuntimeLibrary(api("com.ezylang:EvalEx:3.2.0"))
5878
}
5979
```

0 commit comments

Comments
 (0)