Jump to content

When should you use @OnlyIn(Dist.DEDICATED_SERVER)?


Keheck

Recommended Posts

I was looking for uses of that distribution side, but no class uses that annotation together with this distribution side... (aside from net.minecraftforge.fml.common.Mod.EventBusSubscriber)

 

The javadoc in net.minecraftforge.api.distmarker.Dist class says the following:

Quote

DEDICATED_SERVER is the dedicated server distribution, it contains a server, which can simulate the world and communicates via network. (from the javadoc of the class)

 

The dedicated server distribution. This is the server only distribution available for download. It simulates the world, and can be communicated with via a network. It contains no visual elements of the game whatsoever. (from Dist.DEDICATED_SERVER)

But that didn't help clarify on what should only be processed on the Dedicated Server side, and does that distribution side also exist on singleplayer worlds?

 

I know that Dist.CLIENT is used for stuff like rendering, but when is it appropriate to use Dist.DEDICATED_SERVER?

Link to comment
Share on other sites

Basically you should never yourself be using the @OnlyIn annotation unless you are overriding a method with the annotation already.

Apparently I'm a complete and utter jerk and come to this forum just like to make fun of people, be confrontational, and make your personal life miserable.  If you think this is the case, JUST REPORT ME.  Otherwise you're just going to get reported when you reply to my posts and point it out, because odds are, I was trying to be nice.

 

Exception: If you do not understand Java, I WILL NOT HELP YOU and your thread will get locked.

 

DO NOT PM ME WITH PROBLEMS. No help will be given.

Link to comment
Share on other sites

No, You should NEVER be using these annotations.

Not even for your rendering code.

Not even if the overridden method has it.

NEVER.

If you run into sided issues, bypass it using proper side checks.

If you never call the client side code, on the dedicated server, it doesn't matter if the classes are in your jar.

 

If some other mod/code reflectively access your class in the one specific case where you have a method with a sided class in your signature. Then there can be issues. However those issues are on the side of whomever is reflecting into you unnecessarily.

 

  • Like 1

I do Forge for free, however the servers to run it arn't free, so anything is appreciated.
Consider supporting the team on Patreon

Link to comment
Share on other sites

32 minutes ago, LexManos said:

Not even if the overridden method has it.

That differs from what I'd heard previously.

Apparently I'm a complete and utter jerk and come to this forum just like to make fun of people, be confrontational, and make your personal life miserable.  If you think this is the case, JUST REPORT ME.  Otherwise you're just going to get reported when you reply to my posts and point it out, because odds are, I was trying to be nice.

 

Exception: If you do not understand Java, I WILL NOT HELP YOU and your thread will get locked.

 

DO NOT PM ME WITH PROBLEMS. No help will be given.

Link to comment
Share on other sites

I don't care what you heard previously, you heard wrong.

The ONLY reason to use this annotation {which triggers ASM hackery} is to prevent a hard crash.

The ONLY reason there would be a hard crash is if someone tried to invoke your sided method, or reflectively resolve it.

That would ONLY be a method that has a vanilla sided class IN ITS SIGNATURE.

In both cases it is better to NOT do the stupid thing that causes the error then it is to rely on ASM hackery.

 

If it's someone else doing it then yell at them to stop being stupid.

 

If ALL else fails, and it's LITERALLY the last result, seriously "Dont use the other mod that is breaking shit" is 100x more preferred to ASM Hacks. Then ONLY use it on the specific method that is causing the error. Then sure use it. But 99.99999999999999999999999999999% of the time using sane coding practices beats relying on ASM Hackery.

I do Forge for free, however the servers to run it arn't free, so anything is appreciated.
Consider supporting the team on Patreon

Link to comment
Share on other sites

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...

×   Pasted as rich text.   Restore formatting

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.

Announcements



×
×
  • Create New...

Important Information

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