Jump to content
View in the app

A better way to browse. Learn more.

Forge Forums

A full-screen app on your home screen with push notifications, badges and more.

To install this app on iOS and iPadOS
  1. Tap the Share icon in Safari
  2. Scroll the menu and tap Add to Home Screen.
  3. Tap Add in the top-right corner.
To install this app on Android
  1. Tap the 3-dot menu (⋮) in the top-right corner of the browser.
  2. Tap Add to Home screen or Install app.
  3. Confirm by tapping Install.

Having a really hard time making sense of the API

Featured Replies

Posted

Maybe I'm blind, but the only "docs" I have found are these (MCForce ReadTheDocs).

Normally, when I think of an API documentation, what I have in mind is something that outlines the main classes and methods provided, and if I'm lucky, even a quick description of what they do.

I am new to modding Minecraft, but I find it odd that I have to go through YouTube tutorials to get examples on how to do pretty much anything, specially when I've gotten to using DataGenerators and most of them just write the JSONs by hand (I'd ask WHY, but the answer is lack of proper documentation, at least as far as I'm aware).

If such a documentation exists, I'd be very thankful to be pointed to it. Even better if it covers the 1.17 version of the API. 

P.S.: Is there something similar for the "net.minecraft" packages?

Edited by KRKWMSM
bad grammar

  • Author
19 minutes ago, diesieben07 said:

Forge has some Javadocs, yes. But they are not hosted anywhere, you can look at them in your IDE (or run the javadoc tool yourself if you want the HTML output).

The other thing is that Minecraft is an obfuscated game. There is no documentation for its code. It is only recently that Mojang has started releasing the "official names", which are the class, field and method names. This is now used by Forge since 1.16.5 and so you will have at least the original class, field and method names in your IDE for Minecraft's code. Then there is the Parchment project, which is sortof a successor to the previously used crowdsourced MCP names, and provides parameter names and javadocs (community contributed) for Minecraft's code. Again this is visible in your IDE when you set up a modding project, it is not hosted online (this time for copyright reasons). See here: https://github.com/ParchmentMC/Parchment.

I'll check out Parchment. This is basically what I'd select as the "mappings" in the "gradle.build" I assume. Thanks.

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.

Guest
Unfortunately, your content contains terms that we do not allow. Please edit your content to remove the highlighted words below.
Reply to this topic...

Important Information

By using this site, you agree to our Terms of Use.

Configure browser push notifications

Chrome (Android)
  1. Tap the lock icon next to the address bar.
  2. Tap Permissions → Notifications.
  3. Adjust your preference.
Chrome (Desktop)
  1. Click the padlock icon in the address bar.
  2. Select Site settings.
  3. Find Notifications and adjust your preference.