docs-website

[shell minnow]

I suppose setting this to false results in potential issues, right? It's not really clear from the description which state is the ✨dangerous✨ one.

[serene vault]

Yes, true is the safe state. Probably not the right channel, but I guess this could use some clarification in the docs

[echo canyon]

if I want to add a new page, I just add it in docs, and then reference it in the appropriate sidebar?

[young matrix]

Yeah

[echo canyon]

I was thinking of writing a guide on the ChatRenderer, but as I'm literally typing this out, I realize that's gonna change here shortly anyways

I was just reminded of that by a guy who was confused by that system

[eager plover]

Yea, adventure in general has been a fun one

Like, /adventure generally covers the getting started pretty well, but, then you also get into stuff like the serialisers, etc

[clever basalt]

why isn't there a link on https://papermc.io/javadocs to https://jd.papermc.io/velocity/3.0.0/?

[echo canyon]

cause no one's prd it yet I guess

[clever basalt]

sounds like a free pr

indentation is cursed on waterfall 1.16 though

[plucky lichen]

would be necessary a doc or blog post explaining the position of the paper team with the chat reporting and what does and does not the server software paper?

[spice temple]

The latest announcement on the forums contained that info

And we are still working on API so that plugins can support chat reporting

[plucky lichen]

great, so then you can just give a link to that info to the people asking and discussing about that topic and avoid unnecessary drama.

[supple comet]

re 76: The quotes aren't necessary, right?

[supple comet]

@coral gulch mentioning jwt is too specific imo

ninja'd by aurora

[crystal bridge]

[eager plover]

It's too speculative, etc

Also, it's not really missing classes

It's missing library dependencies

[crystal bridge]

Makes it harder to understand

But yeah, Those variants miss required dependencies for Paper, and are therefore not recommended. would work ig?

[neon atlas]

Gotta keep in mind this is mostly for server admins

[crystal bridge]

Ah, maybe add an s to variant in the title as well

https://docs-84bn4qy0o-papermc.vercel.app/misc/java-install i do love that it automatically creates a preview

[echo canyon]

wrong channel. and 1.8.8 isn't supported here

[broken galleon]

Can I create Config files for Plugins in Velocity? And if I can, then how?

ok, nvm found a good library

[twilit pivot]

Yes, with Configurate 3 or toml4j, both are included in Velocity
#velocity-dev

[lethal lance]

Quick question. I am currently on https://docs.papermc.io/paper/dev and I am trying to look at the "development guide" posted their but nothing seems to be happening when I click the button for the guide or anything.

[neon atlas]

That section is still empty so you don't get anywhere 😅

[lethal lance]

ok thanks

How do I visit the 1.19 javadocs?

not 1.19.1 or 1.19.2 the 1.19

[neon atlas]

We don't maintain javadocs for minor versions. They are unsupported in the first place

[autumn tulip]

yo, how do i get livingEntity from player.getVehicle?

trying to give the entity a postion effect

[neon atlas]

See #paper-dev for Dev related questions

[autumn tulip]

ight np, its a hassle going through the docs so i though this was a decent place for it

[twilit pivot]

It would be nice to make a small guide of the configuration libraries included in Velocity and how to use them in a basic way? Currently several Velocity plugins still use toml4j which is deprecated and will be removed in a future release of Velocity https://github.com/PaperMC/Velocity/blob/dev/3.0.0/api/build.gradle#L31 and it would be good that there is a guide to encourage migration to Configurate 3. And in what section I could put the guide?

[young matrix]

that sounds great! I'd probably go Development -> how to guides. Although I'm not totally sure that is the best place.

sorta similar to the "Porting your plugin from velocity 1.x.x" page

or could also take a different direction and go for a more general configuration guide, laying out each option available with just a big warning above toml4j - although configurate already has docs and there is not very much velocity specific (are there any custom serializers bundled? I don't even know). so I'm not too sure how useful that would be

[supple comet]

The link the edit this page button links to seems to be incorrect

It removes the "platform category" from the file url

[crude epoch]

It's upcoming but not available yet

For now, this is about all the reference available: #admin-announcements message

nope

[fair river]

99.99% of server uses default @slow wasp

Is the most optimal

The only time the config option should be changed is provably during period of pregening before server opens

[crude epoch]

Changing the settings won't affect that much at all then

Basically you'd only put yourself at higher risk of screwing things up by overallocating

[fair river]

That still means default will work best for you

Default will use whatever is possible when it finds necessary

It will be added when ready. Be patient.

[serene vault]

Everyone can though, it's a GitHub repository

You can make a PR with it

[fair river]

This channel will be where you report doc related problem, yes.

[serene vault]

That's a known issue. Pretty sure it will just redirect you here though: https://github.com/PaperMC/docs/

But eternity is right, I'm sure it will be updated soon by someone

[fathom terrace]

Reg #announcements please make a forum post or something that we can share
this info is good but sharing a discord link is not very credible and hard to follow up on
(reposted from my message in #general, sorry)

ideally in https://forums.papermc.io/forums/papermc-announcements/ I guess?

[spice temple]

good point, we are on it 🙂

[crude epoch]

https://forums.papermc.io/threads/malware-announcement.529/

[fathom terrace]

appreciated

when possible, please also append the additional information you have found there

[crude epoch]

absolutely, it'll grow as our knowledge does

[spice temple]

since its hacktoberfest now: if anybody needs a good place to do a really productive PR, look no further! https://github.com/PaperMC/docs/issues/23

[neon epoch]

https://github.com/PaperMC/docs/pull/82

[last bear]

This one was also added today, https://github.com/PaperMC/Paper/commit/e9618f878019c50109009f4814efb3589cfbb6a4

should also do a quick code search for Boolean.getBoolean( and System.getProperty( in the patch dir to make sure no other new ones were missed

[neon epoch]

will do

[last bear]

awesome, thanks

[neon atlas]

^ the nag message one is missing (beyond a few others off the top of my head), but I'll let you do the find in project thing first 😅 (thanks for the PR really needed)

[neon epoch]

does the docs repo have hacktoberfest progress enabled? I don't mean for it to sound like thats the only reason I made the PR... but it was a contributing factor 😝

[spice temple]

done

[drifting slate]

I feel like it could be worth adding a note about PaperMC's separate configuration file(s) in the Getting Started page (https://docs.papermc.io/paper/getting-started)?
Perhaps in the "From Craftbukkit or Spigot" section.

Tho, doesn't need to be a own section. A :::tip could imo be already enough. Would be open to add this myself real quick.

[ocean void]

To configure your server, see the Global Configuration and Per World Configuration pages.

That's in there already.

[drifting slate]

Is kind of like a throw-away line here... At least it gives me such a feel...

[ocean void]

It's a pretty short doc and that's at the end of it. Basically at the step where you'd start doing configs.

Those are links which dump you into the respective config pages which have lots of more info

https://docs.papermc.io/paper/reference/global-configuration

For example

[drifting slate]

mkay

Regarding https://docs.papermc.io/paper/adding-plugins#finding-plugins, maybe add Modrinth?
Or consider a separate page to list known pages? Not sure tho... Still think we could give Modrinth a bit of exposure here, as it sure is better for Paper-specific plugins than Spigot or BukkitDev... (Why even mention BukkitDev? That's like the worst of the bunch)

[spice temple]

Are there any plugins on there?

[drifting slate]

Since weeks now

https://modrinth.com/plugins

[spice temple]

I know it's possible, I mean actual plugins in numbers

[tawny sluice]

more than on hangar 👀

[ocean void]

Lots of stuff is still on bukkitdev and comes up in Google searches still, so it's worth having it there.

[drifting slate]

1. Once you've found the plugin you'd like to install, download it. Ensure the file you have downloaded ends in .jar. Some plugins also distribute as .zip files, in which case you will need to extract the file and locate the .jar for your platform, often labelled bukkit or paper.

That's a.... very specific mention there... Like why this particular mention of "often labelled bukkit or paper"? Feels weird

[crude epoch]

true, a good example is vault

[spice temple]

World edit

All engine hub stuff is on cf

[drifting slate]

Tho, that is also on Spigot, and I get more spigot recommendations than anything about it

[ocean void]

Labelled that way because that's how stuff is labelled.

Plugins/etc have forge versions or bukkit/paper versions also.

[spice temple]

Cf payouts is still something no other platform can provide

[ocean void]

So you want to make sure you download the right zip.

[drifting slate]

Coming to Modrinth soonish.

[drifting slate]

Maybe rewrite it tho.
Like:

1. Once you've found the plugin you'd like to install, download it. Ensure the file you have downloaded ends in .jar. Some plugins also distribute as .zip files, in which case you will need to extract the file and locate the .jar meant for your platform. These jars usually have the platform such as paper or bukkit in their name.

[fair river]

I just want to say thank you everyone whos taking an interesting in completing/improving the docs

[drifting slate]

I only do because of Hacktober

[ocean void]

I'm not sure that's much more clear to me, personally. You can kinda nitpick a sentence endlessly, though.

[ocean void]

Oh, that's disappointing.

[drifting slate]

Actually, I really do, but I want to make a good contribution here and not just "correct typos".

And docs is the most I can help with Paper as I seriously can't deal with the patch system

[ocean void]

If you want to contribute to docs there's a lot of stuff that could be added or improved that isn't just typos or moving around sentences. I'd take some time to find something that looks like it really needs work and then submit a good PR.

[drifting slate]

why is the inline code text larger than the normal one? This hurts my head....

[drifting slate]

Yeah. Found a small thing that needs updates:
https://docs.papermc.io/paper/migration#from-craftbukkit-or-spigot mentions the paper.yml, which now is outdated... Question tho is, should it be updated to just mention the new config location, or also mention the old one?

Another thing here:
https://docs.papermc.io/paper/migration#from-fabricforge

Maybe mention Sponge as the only good alternative for a mod+plugin hybrid, tho with the caveat that the API is different and Paper plugins won't work on it?

[ocean void]

Haha if you have a PR make a PR!

[drifting slate]

I first want to find some more possible changes

[ocean void]

I don't think we want to recommend any hybrids.

Which is what that means.

Mods+plugins

[supple comet]

Docs are versioned, so only mention the new one

[ocean void]

^

Was about to get to that. Thanks Noah

[supple comet]

correction, looks like the docs are only versioned when specifically overridden

[ocean void]

But I'd still mention the new one

[drifting slate]

I mean, can you call Sponge a hybrid? After all is it designed specifically with mods in mind (At least SpongeForge), so I myself won't call it a hybrid... Especially since it's also a diffrent API and not just "Squeeze Paper and Forge together and call it a day"
It's just that the line gives me (And probably anyone else) the impression that ANY mix of mod and plugin server is bad and shouldn't exist, when there are possible ways.

[spice temple]

Sponge forge is a hybrids

It has two different apis

Sponge and forge

Sponge vanilla isn't

But yeah, we don't hate on sponge forge

[ocean void]

The line just says we don't recommend it, which we don't :)

They exist, we just don't really recommend it officially.

[drifting slate]

You just use some of their stuff like configurate /j

[ocean void]

We like Sponge, we just don't recommend the plugins+mods hybrid stuff.

[drifting slate]

(btw: Configurate update for Paper plugins when™️?)

[supple comet]

Specifically bukkit plugins + mods, that is

[ocean void]

Yeah

[drifting slate]

The development guide is really detailed... Like... Wow, so many pages. (Sarcasm for those who don't get it).

Question is, what should these pages contain?

Perhaps a page about what Paper brings for the dev that they can't get from competitors?

[fair river]

I think the first few page should be beginning friendly namely the initial setup if we do wish to bring in more interest and allow it to be a lower barrier of entry.

A more advanced guide is always welcomed but currently I believe we have none (not counting the one on GH)

[drifting slate]

Still think a "Why Paper?" page on the docs to give a more in-depth look on what makes Paper better than Spigot or Craftbukkit could be a good addition. Especially for the Administration section of the docs

Velocity has such a page, so why not Paper?

[spice temple]

Sounds great, can piggy back off of Aikars reddit post maybe?

I remember we shared that around back in the day, maybe somebody can find the link

[jovial shell]

Is it in the scope of the docs to write a page on using the BungeeCord messaging channel but with Velocity API examples so we don't have to keep sending people to spigotmc for it?

Semi related, when is Velocity's website getting redirected to the Velocity docs on the Paper site?

[burnt ice]

I'd say yes, it's still something that is widely used 👍
Would be nice to see modern updated examples.

[violet bough]

SpongeForge is perfectly fine

the API is specifically and intentionally designed to work in tandem with forge and mods

It comes down to what is it you need and want, what plugins or mods are available on each platform that you need, what kind of user experience do you want, etc

[eager plover]

^^ The big issue with bukkit + forge, is that bukkit just wasn't designed with that in mind; any data which mods add is practically 100% invisible in the bukkit ecosystem

and, yes, part of the reason why the dev area exists is so that we can have vetted guides around how to do things

I know stuff can get opinionated, which is why it's never going to be perfect, but, common recommendations such as how to use MySQL properly in a plugin; people have some horrific abuses of the JDBC API

[spice temple]

That def sounds useful!

[pulsar slate]

Would a guide on using the new Chat API be useful as of now? I know some stuff is still marked as experimental...

[neon atlas]

probably be best to wait for adventure to finish up their stuff

right now we don't really have anything close to full support

[last bear]

although examples for the chat event with its decorator would be nice, with small references to the other things and explicitly linking to adventure docs

[eager plover]

Given our plan to hardfork down the line, yes

a lot of stuff between the two wikis is just outdated or objectionally bad

They just copied the bukkit wiki

[jovial shell]

I'm going to be working on the plug-in messaging thing today, I've already made the page on my local instance but I need to write the content

Are we going for more handholdy or enterprise with docs that include code samples

[last bear]

handholdy

but also code examples

[jovial shell]

I'll be back later with developments then

[last bear]

cool

[eager plover]

Yea, need to consider that a good % of people reading this stuff will be somewhat new to the ecosystem and even java

Part of the goals of documentation is to avoid having the same discussion 200 times

Oh god, reminds me of college/uni

[supple comet]

Comment needs clarification as to where it’s printing, I was eagerly waiting at my printer before realizing it might’ve been the console

[neon epoch]

sorry noah but printers are dead technology

[scenic gull]

// mbaxter
// CS 101
// Project 3.2 part B
// This code will attempt to print 'true was true'

[slate scarab]

"will attempt"
no promises!

[jovial shell]

i put this under the velocity section of my docs and after writing two examples that only use the bukkit api maybe i should move this to the paper section lmao

hmm

[jovial shell]

https://docs-m800mecna-papermc.vercel.app/velocity/dev/plugin-messaging

fuck it lol theres the page and assoc pr https://github.com/PaperMC/docs/pull/84

[burnt ice]

@jovial shell lmk if you need any clarification from me, ping me whenever.

[last bear]

if anyone cares to pr https://github.com/PaperMC/docs/pull/83#pullrequestreview-1130374471

[neon epoch]

ill just add it to my existing branch

[neon epoch]

https://github.com/PaperMC/docs/pull/85

I wanted to keep some warning about the libraries field, as it is still a bit sketchy.

Also added the chunk on package naming

[spice temple]

Yes, but that seems like a giant hassle for not much benefit

[neon epoch]

lmk if there are any more pages that need work on / adding

[last bear]

just, everything, really

how to work with configs, event listeners, commands, the scheduler

[neon epoch]

[eager plover]

Part of the goal is to replace referencing the bukkit/spigot wiki for stuff, especially as long term, stuff is going to diverge; i.e. we have extra perms and such which don't exist on upstream, and all that jazz

I want properly vet'd dev resources, around basic topics such as writing commands (especially as that's going to expand down the line), event listeners, etc

and then maybe potentially more complex topics which can be a bit more opinionated, i.e. how to mysql

[neon epoch]

I mean, Event listeners are generally not easy to get wrong?

[eager plover]

well

[neon epoch]

its pretty simple.
Make class implement listener
make @Eventhandler method
register it

[eager plover]

I see people coming from sponge once in a blue moon who try to use sponges event handling "tricks"

part of the thing is that stuff starts to link together fast

[neon atlas]

we should probably come up with some structure to further organise the docs instead of just one giant list of articles

[eager plover]

creating an event handler is a good reference point for documentation just to note it down

But, then you also get topics which relate highly towards it, i.e. how do I call X method from here?

[neon epoch]

I was thinking that, its gonna become a big list pretty soon

[last bear]

what are priorities, make the methods public, some good practices

how do I find events

[eager plover]

it shouldn't need to replace the "how to java" guides, but, sadly, there is probably going to have to be a tad bit of hand holding towards some basic concepts such as DI

[neon epoch]

people make private event listener methods?

o.O

[neon atlas]

yea, I mean project setup and plugin yml are fine to be "top level" I guess ? Tho I presume we could also just have a "project setup" second level and have the project creation and plugin yaml under that

[eager plover]

You can have private listener methods

But, yea, I mean, the layout thing is something I was concenred about for a while which is partially kinda why I preferred the notion of a wiki as that's catagorisable and sprawlable

[neon epoch]

Project Setup
Events
Commands
General Paper API
Misc Java

maybe a How to read a stacktrace / watchdog in the admin section?

[eager plover]

I mean, I think that the gold standard for layout is kinda the bukkit java tutorial

[neon epoch]

also maybe a “why paper / what does paper add?”

[eager plover]

I think that ideally what you'd do is take the general concepts that they describe on there, break it out into pages, avoid the "go to this entirely seperate page" links where viable prefering to just inline such content

[last bear]

but yeah I'd say priority is just some handholding on the most basic stuff you do when starting plugin dev, then later the more general Java help

stacktrace reading is also useful for server owners to find out which of their plugins is broken

[night kiln]

oops sorry my bad

[clever basalt]

do you guys want some docs for velocity for hacktoberfest? i see some things listed in the old repo https://github.com/PaperMC/velocitypowered.com/issues/3

[spice temple]

Sure!

[delicate grove]

What is the next step for paper doc?

Update development section?

[last bear]

this plus scheduler usage minus events, plus https://github.com/PaperMC/docs/issues

[neon epoch]

https://papermc.io/using-the-api#gradle

can point at docs now?

[narrow quail]

hello! I've been interested in helping write docs for a little while now. It would be nice to contribute to the community and I've been wanting to work on my technical writing skills.

I wouldn't mind taking on https://github.com/PaperMC/docs/issues/36, but past that, I'm not sure where I should start. I assume documents like that would go in admin/reference (https://github.com/PaperMC/docs/tree/main/docs/paper/admin/reference )?

[narrow quail]

okay, thank you

[narrow quail]

how would one go about making a new file accessible through a route on the web server? I want to see the page rendered to make sure I got the formatting right

[neon atlas]

https://github.com/PaperMC/docs/pull/84/files#diff-4984c869fd20d441d095beea1c181defcde6e7dfb164254840963a1bdcdf8040R87 for example

is how you'd do the trick

[narrow quail]

Riight okay, thanks Lynx

[neon atlas]

np 👍 basically the sidebar config is the way to go

[narrow quail]

Skipped over the config folder when initially reading the repo

[neon atlas]

we all hate configs 🙏

[narrow quail]

TRUE. Just hardcode your configs.

[eager plover]

ah, yes

[narrow quail]

look things are tight over here okay? we can't afford all those columns

[clever basalt]

hitguv

hitgub

[narrow quail]

so I added admin/reference/server-properties to the items list in sidebar.paper.ts's "Reference" category. My file is under docs/paper/admin/reference/system-properties.md in the repo. The new page is visible in the sidebar/reference page, but when I attempt to visit the page, I get redirected to {host}/paper/admin. Any ideas on what would be causing this?

(For context the reference category looks like this):

        {
          type: "category",
          label: "Reference",
          link: {
            type: "generated-index",
            slug: "/cat/admin/reference",
          },
          items: [
            "admin/reference/global-configuration",
            "admin/reference/world-configuration",
            "admin/reference/system-properties",
            "admin/reference/server-properties"
          ],
        },

[narrow quail]

the slug of server-properties was pointing to /admin

[delicate grove]

Is it a typo?

[eager plover]

I think not?

[delicate grove]

I think it's "treasure"

[fair river]

feature means a place that may contain the treasure as there are multiple place like that iirc.

[delicate grove]

Oh, I understand. Thanks.

[eager plover]

Yea, it means gen features, basically

[narrow quail]

when formatting the list of server.properties entries, do we prefer sorting alphabetically or by presence in the server.properties file

[eager plover]

I'd imagine most people looking in there are generally gonna be looking for alpha, rather than "oh, what order was it populated into the config"

and also;
ctrl-f: exists

[spice temple]

The order isn't even defined

[eager plover]

ur not defined

[spice temple]

Properties aren't ordered in java, it's a hash map

So yes, alphabetical:)

[eager plover]

there is a pseudo order because it's a hashmap

[spice temple]

Its not defined 😠

And not stable

[eager plover]

nor am I, but people still respect the order or lackthereof that I bring

[spice temple]

cat

respected

Bahahah

😗

[pulsar prawn]

the docs are so ambiguous sometimes

[eager plover]

Well, the joy is that many people working on the docs are devs

and so it's pretty hard to come at stuff from a user perspective, and sometimes that makes the tonguetangulation not so amazing

[spice temple]

And hint of what's ambiguous is helpful

Then others can step in and fix it

(or tell you that you are stupid, whatever is applicable 😂)

[fair river]

You can list the things that’s confusing to you here and someone may be able to fix it. A fine balance of concise vs too detailed description is also important though.

[pulsar prawn]

yeah i was gonna do it when i get on pc

ive found quite alot actually

[sinful granite]

Hey, the whole docs repo is licensed under CC-BY-SA-4.0 or? I want to migrate a project to Docusaurus and I am not interested in the content of the docs themselves but in the technical structure and code.

[spice temple]

I assume the cc licence sucks for code?

Maybe we can look at that

[sinful granite]

MIT would be a lot easier. Otherwise I have to document every change I make etc

[spice temple]

Yeah, I see

[sinful granite]

Im interested in everything but docs/ or static/ directory

Which is basically where all the content lives

(I'll not fully copy it, just some technical parts and maybe the Projects component)

[young matrix]

I think I'm still the only committer for all of that still so should maybe be fine to add MIT for that? Idk. I don't know much about licensing

But projects component is a pain, because I half copied it from a post by a now deleted user in the docusaurus discord containing this https://cdn.discordapp.com/attachments/947676006964162611/950079634966458398/Screen_Shot_2021-11-28_at_04.06.51_AM.png
https://cdn.discordapp.com/attachments/947676006964162611/950079635159412736/Screen_Shot_2021-11-28_at_04.08.12_AM.png

So that's basically just something I've ignored because no clue how to attribute it/whatever, and it's a pretty smallish modification off the default page

[young matrix]

also, taking a second look there are definitely things in there that are not cc-by-sa 4.0. such as a font (OFL-1.1), the paper logo (?) and the discord and github logo

such a mess

[spice temple]

Licencing, woo

Maybe we should just say, docs are cc, code is MIT, rest might vary? Lol

[sinful granite]

yeah thats a big bonus here, you can decide alone if you agree on relicensing under a more permissive license

[sinful granite]

thats fine yeah. In my mock it's just 100% your code for the component (beside colors) that's why I want to attribute it to you

for reference

[young matrix]

Oh nice. Love the little character you guys have

[sinful granite]

thanks 🙂 yeah like the artwork a lot but it's used too little. most of the time the flat icon is used

[young matrix]

https://github.com/PaperMC/docs/pull/92

[sinful granite]

thanks a lot!

[still apex]

typo: https://github.com/PaperMC/docs/blob/2366ede4b410bd5d584b4088e354452f763576d0/README.md?plain=1#L53?

[spice temple]

wdym?

[still apex]

papermd

[spice temple]

oh

ye

[supple comet]

Free PR :)

[neon atlas]

grinding hacktobefest

[neon epoch]

hacktoberfest t-shirt sucks

i got the tree

[oak quiver]

This year's is definitely an odd one

[spice temple]

That's what happens when weebs take over

[neon epoch]

like the front was fine and then i saw the back and recoiled

[scenic gull]

The link didn't even give me a tree option

[neon epoch]

oh lol

[scenic gull]

So I'm getting a new housework shirt

[pulsar prawn]

kekw

[drifting geyser]

😭

[ocean void]

This is definitely not docs. I thnik you want #paper-help

But also 1.12 isn't supported.

[drifting geyser]

yea i know, im making lobby

[neon epoch]

[echo canyon]

any point in having our own documentation for spigot.yml, bukkit.yml, commands.yml?

or are we satisfied relying on spigotmc wiki for now?

[eager plover]

I mean, at least one of those config files we have tweaks in

part of my hopes with the config thing was that it would be most HF and we could merge all the configs in a single stab

but, I mean, ideally, our site becomes the one stop shop for stuff vs tryna run around, especially as some of those other sites suck for ux

[spice temple]

Yeah, anything a plugin dev might wanna use should eventually be on our site

We can't rely on 3rd parties

[fair river]

I think we should as some of the options there ain’t being used on Paper anymore.

[young matrix]

There are added options too (EAR2, $sender for commands.yml, etc.)

[fair river]

Oh yeah!!! Those don’t exist in spigot server

[left isle]

help please

[north obsidian]

okay

[undone ginkgo]

Oops! We ran into some problems.
You have been banned for the following reason: Spam. Please contact the administrator if this was done in error..

forums.papermc.io
Name: Maximus

[spice temple]

there has been a massive spam wave, you might have been caught in the crossfire

lemme check

@undone ginkgo you should be able to login again now

[undone ginkgo]

tks man, it worked

[spice temple]

np, sadly we have to be quite trigger happy on forum bans

especially if you share IPs with many other people, our systems will quickly ban you, just to be safe

[eager plover]

It's the username that did it, too generic

[serene vault]

should have been XxX_Maximus123_360_Xxx

[slow oriole]

fix-climbing-bypassing-cramming-rule

default: false
description: Sets whether climbing should bypass the entity cramming limit.

so does it fix it or does it allow it ?

if i have it on false, does climbing bypass the limit ?

and for what is that option? Should i enable it ?

[south thunder]

Not sure if this is more suited for #paper-help, but setting it to true enables the fix for that bypass, disallowing entities climbing a ladder, etc, to not suffer cramming damage

[spice temple]

I feel like the description can be improved there

Your explanation also has a double negative, lmao

If false, climbing bypasses the cramming rule, if true, climbing entities will take damage from cramming

That's what it boils down to, right?

[eager plover]

Yes

[slow oriole]

thank you all for the answers

[south thunder]

I'm not very good at this, yeah, lol

[spice temple]

I feel a more concrete and less double negated explanation fits better

Easy PR for somebody who doesn't sits in bed already 👀

[slow oriole]

i was confused by the explanation in the docs

[spice temple]

Yeah, it's good to bring stuff like that up here so we can continue to improve it

[spice temple]

That sounds nice

Game rules with space I would say

That's how it's in the client

[spice temple]

maybe that should be a different PR tho

but ye, I dont hate that

or just do a different commit in the PR, thats enough separation

[delicate grove]

Does "tools" here mean "paperweight"?

[echo canyon]

where is that from?

I don't immediately recognize those 7 words

[delicate grove]

https://docs.papermc.io/paper/dev/project-setup

[echo canyon]

yeah, basically means use gradle if you want to use paperweight userdev in your project

[neon epoch]

I wrote those pages and err.. GH copilot sucks at english i guess

[neon atlas]

👀

[spice temple]

Dum copilot strikes again

If you want something good, do it yourself

[neon epoch]

Yeah I was writing and then it would suggest something that looked like what I was going to write. just not quite. Honestly I am having the same issue with my own writing in an essay I am proofreading atm

[echo canyon]

People use copilot for writing actual text?

[fair river]

I mean copilot got better English than me

[clever basalt]

I used copilot to write an entire blog post before so it definitely can

[delicate grove]

I'm reading Bukkit Wiki. And I found this when I reading Plugin YAML.

Is it still available now?

[young matrix]

no. that was removed I want to say 1.12-1.13ish

because absolutely nobody used it

https://www.spigotmc.org/threads/removal-of-ebean-orm.194144/

[delicate grove]

Thanks 😄

[echo canyon]

Do we have a list of “guides” we want to have written up at some point? I know we want to have some of that stuff on the docs site.

To replace some of the spigotmc wiki pages we link to

[neon epoch]

development wise:
Commands - Maybe brigadier as well?
DI vs Static Singleton?
Config Files
Proper Database usage - ie not GB's of yaml... could be merged with the former
Scheduler programming & what the main thread is
Attaching debuggers & running paper from the IDE

[spice temple]

We should totally have a Todo list issue about that

[fair river]

I think the most beneficial one will be how to get started type of guide for people either want to contribute to Paper or make plugin using papers API etc…

[last bear]

contributing is less interesting, we have that already; mostly the beginner guides as were listed a while ago and now by ollie

https://github.com/PaperMC/docs/issues/100

[young matrix]

One of the earlier messages in #bugs-bunny has a bigger list too

Was that the channel name? Don't remember. Something like that

[last bear]

scrolled through the channel and didn't find one, any specific term I can search for?

[echo canyon]

I guess it was deleted. WOW

blame coreteam

I kind of thought they should each be their own issue, so comments could be posted about specific ones, instead of tyring to have a conversation about 15 of them in one issue

[last bear]

god bless gh for making that action a single click

[rugged bay]

rip #paper-github

[last bear]

Having one issue listing them all is still nice so it's easier to overview. could also be a project, but here it's probably easier as two meta issues (one for plugin dev, one for server owner)

[echo canyon]

sure, can have both

maybe should have new labels?

[last bear]

sounds good

[echo canyon]

do we have a way of having dynamic (on build) links for the docs? I just noticed we have a link to the 1.19 javadocs. It'd be great if we could have a shorthand for linking to the javadocs for the latest supported version. Like when the docs site was built after a deployment, it would insert the latest version there?

just to minimize the amount of manual updating of the version we have to do

[young matrix]

Yeah you can do that. Something I wanted to do as well, a lot of places with latest version

I can make a pr this weekend

[echo canyon]

where do you think the best place to get the version is? Can you have it query the downloads API to get it that way? Also the javadocs are only the first two numbers (1.19) not the full (1.19.2), so that'd have to be taken into account

[young matrix]

Yeah downloads api is what I would do for other instances

For java docs though it would be really great to have a /latest path or something though

[echo canyon]

I guess a /latest for jd isn't nearly as bad as /latest for downloads

[young matrix]

For here it's fine, but especially for being able to search java docs on Google it is completely messed up with the versioning that is there now

[delicate grove]

Is this a typo?

[south thunder]

Yes

[fair river]

Free PR!

[supple comet]

Guys, please throw the core 1.12.2 Paper. Constantly writes error 403.

[young matrix]

just an idea I had based on #paper-help, but thoughts about a "what is a server?" page?

as in way broader than the existing what is paper page

did some quick googling and couldn't find anything decent explaining in laymans terms what a server actually is

as in how can a physical thing be a server and software be a server? what does it actually do? etc., and then maybe (on a separate page?) stuff about what in minecraft is processed server/client side, because thats also often confused

could probably also fit in with a "what is a proxy?" page. although, even as it is sorta more advanced that would be simpler to explain to someone who has no clue

[serene vault]

Maybe just a "Glossary"? There are a few others terms that might need explaining

[young matrix]

oh, that is a way better idea

[echo canyon]

Key Terms
Bad Practices: https://www.twitch.tv/kennytvn/clip/ComfortableTrappedMilkTheRinger-s3tIeBPuu1tE-AJ_

[rich dome]

https://youtu.be/VXmvM2QtuMU

Maby this helps?

[eager plover]

Yea, nomenclature, especially within a community context is hard; i.e. velocity, etc, are servers, yet, are rarely referred to as such outside of more typical discussions such as port forwarding, in which the link isn't exactly clear towards outside folk; it does get complex in terms of describing words when they have two contexts, server; in the sense of a role of an application that listens to the network, and server in the sense of a "backend server" in the sense of a proxy network

[neon epoch]

Was gonna work on a PDC page today, Should I create a dropdown for just "Development Guides" or something

[neon atlas]

Well event API being top level makes sense , I wonder if we want to split "smaller API concepts" into some misc section

[neon epoch]

I mean yeah, that was the thought process behind "Development Guides" but some other name is fine.

[sonic drum]

hi, anyone know how to download spigot for 1.17? There is only 1.19 on the site

[hard quartz]

this is not the place, #paper-help and you can get the legacy versions from: https://papermc.io/legacy

[sonic drum]

thx

[echo canyon]

Also, spigot. Yikes

[hard quartz]

Ohhhh i dont read this part xd

[broken galleon]

Is there a way to show custom toasts with the api?

Like these custom advancements in the right upper corner of the screen

[eager plover]

This channel is for documentation creation

#paper-dev for dev questions

[still apex]

Is this the right channel for an issue with javadocs? (jd.papermc.io?)

Clicking on Handshake here brings you to a broken github link https://jd.papermc.io/waterfall/1.19/net/md_5/bungee/api/event/PlayerHandshakeEvent.html

[eager plover]

Not really, but, I doubt taht I'll fix that

[echo canyon]

do we still want this? I think it was generally done. https://github.com/PaperMC/docs/pull/14
I mean like do we want the concept? or to just stick to the README inside the repo itself

[burnt ice]

IMO readme

But well, for consistency it may make sense to migrate over to the docs website. But because the contributing guide is kinda niche I’m unsure.

Since you click on a link on the readme anyways.

So maybe it might actually be better to have it on the docs? That way we can possibly link additional docs to clarify things that people might get confused on.

[delicate grove]

Is PDC used to manage NBT?

[nimble canopy]

PDC is just a container to store plugin data and it internally uses nbt

but it can't change vanilla tags

wait, it is a docs channel...

[ocean void]

Yeah this belongs in #paper-dev or somewhere else.

[neon epoch]

There might be something like that in an issue but sounds good

[eager plover]

I'd maybe add some tips too; i.e. library plugins are generally something you should keep in

Vault, ProtocolLib, for ex; basically do nothing on their own, yet do a lot of stuff for other plugins

Seen far too many people accuse Vault of crashing their servers os not having vault disables like, 1/2 of their plugins, either in totality or in terms of features

[serene vault]

Maybe a few docs for forks (e.g. how to update and deal with upstream conflicts) would be good too in that context. It gets asked somewhat often, and isn't really documented anywhere as far as I know

[eager plover]

being frank, I'd semi like to maintain minimal documentation around that; Theres far many better tutorials out there in "how 2 git basics" than we could ever maintain

Maybe some advice on tooling flow, like, how to deal with PW itself when you hit a conflict so you don't toast stuff

[serene vault]

yeah, not a git basics tutorial in any way, and it also shouldn't be too detailed, otherwise it leads to people following it blindly but having no idea what they are doing. but there is some paper-specific stuff that could use a little documentation

[tender plume]

i need help

[young matrix]

Same

[eager plover]

best I can offer you is the knowledge that the sweet release of death is awaiting you, some day; maybe hopefully in the distant future https://www.youtube.com/watch?v=oIscL-Bjsq4

[supple comet]

No description for chunk-system

for 19.2

Where I can found newest description for config variables?

[fair river]

It is still a work in progress but generally speaking, leave it at default is what you should do for 99.9999% of server @supple comet Small unofficial writeup https://paper-chan.moe/paper-optimization/#chunk-system

[spice temple]

If anyone is bored, a guide on how to support chat reporting in your plugin and on your server could be cool

[eager plover]

dealing with chat in general, to be fair; Like, the ChatRenderer is always a fun one

[solar hull]

For https://docs.papermc.io/paper/dev/custom-events , where is Component imported from?

[neon atlas]

https://jd.adventure.kyori.net/api/4.12.0/net/kyori/adventure/text/Component.html

the adventure library

[neon epoch]

Hmm thats a point, I didnt include the imports but... meh idk if it really needs them

[neon atlas]

I mean, might be worth linking to adventure docs somewhere early on?

[neon epoch]

honestly i think there needs to be an adventure page

but... im not the person to make it

Component.text() is my range :)

[neon atlas]

As long as kezz doesn't write it and omits all the static imports for a casual text("Hi", RED, UNDERLINE)

[echo canyon]

I think we should have a Component API page on the dev docs that mainly just points to the adventure docs

although that is more general, I'd need to look at the adventure docs to see if maybe we only need to link to parts of it

[neon epoch]

are there adventure docs or are they just JD's

[echo canyon]

there are

[last timber]

https://docs.adventure.kyori.net/

[cerulean anvil]

This is gonna sound like a really stupid question but is there anyway of downloading 1.17 paper from the website, as the only one i can see is 1.19? thx

[oak quiver]

https://papermc.io/legacy

[hard quartz]

only for know... vercel has a rule for the ci skip? (i added a few late...)

[last bear]

Skipping the ci is only important on Paper/Velocity/Waterfall since that produces builds then pushed to the website

[hard quartz]

okay i ask because the PR not need generate a preview for this.

[queen gulch]

??

Firstly, how did I got this name?

Secondly, why did I got a notification?

From here

[fair river]

Taken cared. Don’t worry

[solar hull]

Why https://docs.papermc.io/paper/dev/handler-lists not mention about registering a listener?

[eager plover]

Because you generally don't mess with the handler list directly for that

[scenic gull]

Great question for #paper-dev 🙂

[glacial pine]

Oh sorry 😓

[gray hemlock]

dumb question but I cannot for the life of me find an up to date guide on how to configure / setup a modded server with paperMC

anyone have a link for such a thing?

[echo canyon]

papermc doesn't support mods. also #paper-help

[gray hemlock]

shiiiiiet

[spice temple]

That structure sounds nice

Maybe something about reading stack traces to find the plugin in it

[serene vault]

Maybe 02-03 should be "check for updates for the plugin". Quite a lot of plugin issues are already fixed by the author, people just aren't updating their plugins regularly.
Also might be a good idea to include something about updates to plugin dependencies there, or just directly mention ProtocolLib. After every Minecraft update there are quite a lot of people who didn't update PL and it causes some issues for them

[steady fulcrum]

Also would be helpful to include trying dev builds of plugins too since some main builds don't support the latest version.

[echo canyon]

I feel like the 01, 02, 01.02, labelling system isn't super intuitive? or at least in that format from your link, it is confusing

probably useful to have an example stack trace, since they usually all look the same to someone who might not know what a stack trace shows

[granite raptor]

the docs for

  gen-parallelism: default
  io-threads: -1
  worker-threads: -1``` is not done yet?

[ocean void]

Correct, not done yet

[neon remnant]

Not sure if this is the right channel but I wanted to take a look in the Documentation of the class ConnectionRequestBuilder (Velocity) but get a 404 WHEN I USE THE SEACH BAR

If i go on https://jd.papermc.io/velocity/3.0.0/ an then go to ...api.proxy -> ConnectionRequestBuilder it works (https://jd.papermc.io/velocity/3.0.0/com/velocitypowered/api/proxy/ConnectionRequestBuilder.html)

When i Use the Search Bar I land on this page: https://jd.papermc.io/velocity/3.0.0/undefined/com/velocitypowered/api/proxy/ConnectionRequestBuilder.html

[eager plover]

known issue, it's a bug n the javadocs util

[neon remnant]

okay perfect

[eager plover]

I did take a stab at fixing it a yesterday, but, that apparently failed \o/

oh, I see what's happening

fixed

[neon remnant]

👍

[ocean void]

Post in #paper-help

Not here

[supple comet]

Oh okay sorry

[echo canyon]

is this the new recommended mode? #paper-github message

should update the anti-xray docs regardless

[supple comet]

Free pr ^

[neon epoch]

https://tenor.com/view/unbothered-dont-care-gif-10164834

[mild cairn]

I'm not sure if we should outright recommend it. I mean, so far, we have not had a recommendation for mode 1 or 2 either. Mode 2 still has the best protection due to its randomness. Ofc, when someone has issues with networking etc., we can still tell them to try mode 1 or 3.

Ofc, as you said, it must be documented including its pros and cons. For the recommended settings page I'd change the title of this section https://docs.papermc.io/paper/anti-xray#engine-mode-2 from engine-mode: 2 to engine-mode: 2 and 3. I don't think that we need an extra section.

In the FAQ section below we should add a section about networking/ping issues and recommend switching to engine-mode: 1 or engine-mode: 3.

In the intro part where the modes are described, I'd add one or two sentences like: engine-mode: 3 is similar to engine-mode: 2. The difference is that engine-mode: 3 uses one random block per chunk layer, which mitigates network bandwidth issues.

||(That's just how I would do it. I don't intend to discourage anyone from contributing other/better ideas. Just thought I'd write down my ideas somewhere before I forget them.)||

[past halo]

Hola, algún hispanoparlante?

[empty grove]

Sí

[ocean void]

(They posted in #paper-help also and got an answer)

[echo canyon]

I think the docs bit on paper plugins and bukkits serialization system should be clarified

you can still USE the system, just the automatic registration when a class is loaded is gone

I understand we want to discourage using it (cause its not good), but I think we should be more clear about what it does

[young matrix]

right now it does sorta sound like using the existing native serializers won't work either

which breaking that would be a massive pain, despite their shortcomings

[echo canyon]

this also needs to be clarified in the docs #paper-dev message

I don't see it listed under differences

ofc more will come for that when we add the new command API, but it should be mentioned now at least

[burnt ice]

Totally agree, if someone wants to just directly add that would appreciate

[drifting slate]

This section contradicts itself

[burnt ice]

Yep, that would be the case 😢

[drifting slate]

It first says that you're able to provide a list of plugins that should load after yours but then goes on and say that these plugins load after yours...

Which one is the right behaviour?

[burnt ice]

It's how dependency resolution used to be, so, load-after

[drifting slate]

So my plugin loads after the other?

[burnt ice]

Yes, similar to how dependencies worked in the past.

[jagged trail]

Then the first line is missleading imo

I 100% get the expected behavior but the first line says that "listed plugins will load after your plugin"

[neon atlas]

Isn't that the point that Andre brought up

[jagged trail]

Yes I was pointing to that as I don't understand if Owen see this as an issue

[neon atlas]

Okay 👍

[jagged trail]

I think it would be more clear with:
load-before :

You are able to define a list of plugins that should load after your plugin.
..... 
It means that your plugin will load BEFORE this list of plugins

load-after

You are able to define a list of plugins that  should load before your plugin.
........ 
It means that your plugin will load AFTER this list of plugins. 

Because saying "A list of plugins that your plugin should load before/after" could mean that your plugin is loading other plugins, which is wrong and it also changes the chronological order of things depending on how you read it.

And its even worth when you consider language barrier

[jagged trail]

Meh, I still see some room for confusion, but i guess its a little better

[limber crescent]

where can i get paper 1.19.2?

[neon epoch]

get bukkit dot org /s

[last timber]

https://papermc.io/downloads

[ocean void]

(Someone replied to them in Paper help already)

[echo canyon]

is this still hard for people to understand? its a complex feature, but idk how else to explain it https://github.com/PaperMC/docs/pull/120

The complex part is the way vanilla can parse nbt paths, like SomeCompoundTag.SomeArray[0].Other

but I don't wanna explain that in the docs, the mc wiki prob already does since I didn't invent that format for this setting

[young matrix]

makes sense to me

[neon epoch]

The defaults are set to prevent entities from spawning or moving to a place other than the location they were placed. **For example, if Pos wasn’t included, **a spawn egg could place an entity at any location.

[supple comet]

Hejka

Hello

pls help

[scenic gull]

Do you have an issue with our documentation?

If not ask in the appropriate support channel such as #paper-help

[supple comet]

Could someone help me with engine 2 anti xray

for the nether

[spice temple]

#paper-help

[burnt ice]

https://docs.papermc.io/paper/anti-xray
Might be worth documenting the new 3rd engine

https://github.com/PaperMC/Paper/pull/8799

[hard quartz]

i confuse how can test the docs in local :/
edit: fixed by deleting all the modules installes and install again...

[hard quartz]

so tiny

[young matrix]

Is there blank space around the logo SVG?

If so excess should be removed

[twilit pivot]

Can someone merge the pull request https://github.com/PaperMC/docs/pull/142 ? It's been a few hours, it already has 2 accepted reviews and only 1 number has changed 😄

[neon epoch]

now it has 3 approvals 😂

[twilit pivot]

[plucky patio]

lmao that was fast thanks

[echo canyon]

any one else think it'd be useful to have a docs page just on components/adventure? Not trying to replicate the adventure docs, and it should link to them, but just giving an overview of the integration, where they can be used within the API, whey they are better?

probably should start with what components are

[last bear]

100%

[echo canyon]

oh lol, that's already an issue on the docs repo

what version were components introduced?

or not introduced, but utilized fully in the server

/tellraw was in 1.7, and I think that used components back then right?

[last bear]

A long fucking time ago

[echo canyon]

yeah, I know that, but I want to be specific

[last bear]

1.7?

Let me check in good old Via

[echo canyon]

how did they do translations pre components?

[supple comet]

1.7.2 yeah

[echo canyon]

wait a sec, did other people know this was a thing? Component.translatable("Hey there %2$s, I'm %1$s", Component.text("Jake"), Component.text("Kenny"));

you can order the arguments? for some reason I thought that was not possible with the vanilla translation system

[last bear]

huh didn't know that

[echo canyon]

am reading the wiki page on raw json format, and just happened to see that

[last bear]

omg I found ViaVersion with 1.7 server support locally

good times

[echo canyon]

where's that mojira issue with mojang saying support for legacy gonna be dropped

someone remember what issue it was?

[last bear]

I have that on speed dial

https://bugs.mojang.com/browse/MC-190605?focusedId=993040&page=com.atlassian.jira.plugin.system.issuetabpanels%3Acomment-tabpanel#comment-993040

[spice temple]

we do love lime

[echo canyon]

... why can't I run yarn on the docs?

[ERROR] Error: Config file at "/home/jake/Projects/Minecraft/PaperMC/docs/.meta/docusaurus.config.js" not found.

when I run yarn dev?

I just fresh cloned for this

[last bear]

did you install dependencies?

[echo canyon]

yes

and deleted node_modules and tried again

I can do yarn start, but not yarn dev

yarn 3.2.1, node 16

hmm, if I run yarn install again I get a file already exists for symlink emoji-regex-npm

but it works the first time after deleting node_modules

[viscid thistle]

I had that same problem last week on node 18 iirc

[echo canyon]

it alternates back and forth between succeeding and failing on yarn install wtf

node -v says 16.18.1

don't even have 18 installed according to nvm

apparently just had to update yarn, idk what was going on

@last bear we could link to the vanilla wiki page on the json formmat? https://minecraft.fandom.com/wiki/Raw_JSON_text_format

[last bear]

Yeah

though I'd still include a simple serialized example, then link to that in the same/following sentence

[echo canyon]

what do the docs use to do syntax highlighting? it doesn't support json5

which I'd prefer using over json so my IDE doesn't yell at me for including comments in the json

k, added docs on json and minimessage. For minimessage I didn't give an example, just mentioned it, its benefits over legacy, and linked to docs

I could add some minimessage examples I suppose

probably should for all the formats then, Components, mini, json

[last bear]

A comparison might be nice

do the same thing you put into the json example as minimessage, and mention that this is not possible at all with legacy outside of the text itself and bold/underline style

[echo canyon]

both minimessage and gson are lossless now in terms of serialization?

[last bear]

components serialized as json should always be lossless

not sure about minimessage

[echo canyon]

yeah ik that, but I was wondering about minimessage

it was missing some tags some time ago, but idk what's changed

[spice temple]

MiniMessage should be too

[last bear]

Including item nbt and stuff?

[echo canyon]

I want to add a section on converting between formats

[spice temple]

I know we have tests for that, but I haven't tested it in a while

I haven't touched it in a while either

[spice temple]

@nimble marlin might be a good authority on this

[echo canyon]

if I generalize the page for more than just paper, can I say "Components is now the supported way of represting text for all PaperMC projects"?

does waterfall support components for whatever

[spice temple]

Don't think anybody has bothered

But adventure has a platform for that I think?

[echo canyon]

guess I can just say "Paper and Velocity"

[spice temple]

Waterfall is the ugly child anyways

[echo canyon]

yeah, don't really want to bring up adventure platform

(despite me pr'ing fixes to it)

[nimble marlin]

MM should be losses

I think someone tried to PR adventure integration to waterfall but it was flawed and nobody had the energy to get the PR fixed up enough to be mergable

[echo canyon]

does Velocity have any legacy texxt support anywhere? like deprecated methods in a similar style to paper?

[nimble marlin]

there's no non-componet api

tho I think it bundles the legacy serializer

[echo canyon]

hmm, where's the best place to put this so it covers both velocity and paper? Is there a way to have one page accessible from 2 links at 2 urls?

I think thats fine tbh, as long as there's only 1 page to edit

I can't just make a symlink right?

ok, it seems to work https://docs-fyhrflzeu-papermc.vercel.app/paper/dev/components

I still am planning on adding a section on serializers

[eager plover]

the adventure PR had an ABI break inside of it that I was too ill at the time to look into or figure out if it even mattered

given that I was severely ill at the time, and the fact that I was already kinda burned out with WF in general (as well as some other issues), it was kinda left to die

[echo canyon]

I haven't heard anyone say anything about that. what was it?

[eager plover]

adventure & WF? was a PR some time ago

https://github.com/PaperMC/Waterfall/pull/633

[echo canyon]

oh you were talking abut waterfall

I had no CLUE what you were talking about, whoops I thought you meant ABI break in paper

[eager plover]

I kinda dislike the length of some of those examples on there

like, even in full screen some of the examples on my laptop fall off screen a bit

[echo canyon]

you mean the line width?

[eager plover]

Yea

[echo canyon]

vertical height?

[echo canyon]

I guess I could use just + for string concat there

[still apex]

Component.text() returns a TextComponent.Builder and not a Component iirc?

[echo canyon]

I call build at the end of it, its a builder chain of methods

I guess it could be better to not call build and have the var be a builder, idk

[still apex]

ah didn’t see that only saw the review on that line

[young matrix]

I'm not sure how good of an idea the symlink is for search/discoverability/general confusion

Although I also don't see a fantastic other way of doing it

[echo canyon]

yeah, it feels pretty jank

[echo canyon]

so there probably should be additional separate pages for velocity and paper which have what types are implemented with what

like CommandSender is an Audience, idk what it is for velocity

how should we do that? make a new section in the /dev folder for each called like adventure and have the main components page and another page for each called smth else?

[still apex]

https://docs.papermc.io/misc/assets old logo here & favicon

[twilit pivot]

Just in case, https://github.com/PaperMC/docs/pull/47 is ready to merge and already has a approved review days ago 👀

[opal flare]

merged

[opal flare]

fixed, thanks

[still apex]

what version of yarn & node is required?

https://i.imgur.com/yrKjnuk.png

[alpine crag]

you are missing a file

Error: Config file at "/home/cas/dev/github/papermc-docs/.meta/docusaurus.config.js" not found.

[young matrix]

that file should be generated though

(and node 18 is fine, yean is bundled)

[still apex]

no really?!

it hasn’t generated, tried it multiple times what the readme says

[still apex]

also happens on my dedicated server w/ node 16

[blazing wasp]

Should've mentioned that from the get go

[still apex]

that i tried it multiple times or that it also happens on another machine?

because i tried it on that other@machine right before i typed that

not when i first mentioned that it’s not working

[still apex]

also happens on a (almost) clean install of ubuntu 22 desktop, node v18.15.0 (using nvm)

[still apex]

bumppp

[opal flare]

node v19.7.0
yarn 3.2.1-git.20220626.hash-28ca6ccdc

is what I use locally

[young matrix]

I will look into this in much more detail tomorrow if it is not sorted by then. but I hope to redo how the config is loaded regardless

I always knew the system for that was kinda jank and meant to redo it but then I stopped working on anything paper related, and it worked, at least for the most part

[echo canyon]

Yeah, I had to update my install of yarn to get rid of that exact error.

Even though it’s supposed to be bundled.

Was on 1. Smth locally before

[still apex]

Works after sulu's pr ty

[charred plinth]

what does this even mean

"Powering [empty pulsating gray box] players"

[fair river]

I think someone is working on replacing that to something like download counts

[still apex]

what part of the page is that

[eager plover]

it fetches that data from somewhere

[still apex]

https://i.imgur.com/q6kxFoI.png

if you blocked bstats it'll show empty

[charred plinth]

ah I didn't think of DNS, I had bstats blocked at DNS level

[fair river]

so pipe has all those 100k 1.8 PvP server that people claim don’t show up on bstat

[charred plinth]

lol

bstats actually shows up in a lot of generic adblocking lists

[echo canyon]

I'm not really liking the structure we have for the config files on the docs, am I alone?

its really unclear what sub categories things are in, and its kinda hard to navigate

[serene vault]

aren't the categories the exact same as in the actual config .yml?

[echo canyon]

yeah, they are.

but its hard to read them

cause all you have to go on is slightly different font sizes

the nav bar on the right is nice, but its not complete

it only shows the top couple levels

[serene vault]

It's possible to change the maximum heading level. Not sure if its better like this or not though

It about doubles the length of the table of contents for the world config if I do that. Still better than needing to scroll the entire page I guess.
Im just gonna PR it, mostly unsure about it design-wise so I guess having a few people look at the vercel deployment might be good.

[echo canyon]

so I like having a structure like that, but wouldn't it be better if that table of contents was kinda the whole page and if you clicked on one it expanded a dropdown or smth?

[steady fulcrum]

Could probably throw everything in a spoiler to get that behavior

[echo canyon]

or is it just better to have a giant yml syntax markdown thing with comments to explain stuff?

I guess we'd have to rig up something to be able to have anchors to each setting

[viscid thistle]

Is it just me or does this first sentence not make sense?

"to reduce risk of to space issues"

[eager plover]

Whoever wrote that was drunk

if aikar, probs drunk on ketones

[boreal eagle]

🙂

[opal bronze]

Where on earth do I find the papers standard compilation guide. I wish I just straight up had a guide for compiling a jar

[scenic gull]

I mean it's right on the Paper github but if you couldn't figure that out Folia's probably not the right call for you yet because it's super early.

[opal bronze]

I guess I can't read because there are no instructions to build on https://github.com/PaperMC/Folia

[viscid thistle]

That's not paper

[scenic gull]

Further help with Folia can be found in the Folia channels.

[unkempt hill]

It seems like this is the first time I've seen it
./gradlew applypatches
./gradlew createReobfBundlerJar

[spice temple]

https://github.com/PaperMC/docs/pull/156

thoughts?

also any other places on the docs where we should recommend hangar?

[radiant summit]

generally seems highly biased

I'm also surprised that page doesn't mention Modrinth

[spice temple]

well, we obviously are biased

and ye, I guess modrinth can be added too

[young matrix]

I think that page was made before modrinth added plugin support, should be added (and maybe remove paper forums?)

[eager plover]

Id Maybe keep the forums there for now until. Stuff moves over

[lost lily]

Where are the Folia channels?

[neon atlas]

#folia-help

[lost lily]

Aha! That's the gradle stuff I might have been missing

Whoops, thanks. I didn't have my Folia role enabled

[small harbor]

hello

https://github.com/PaperMC/docs/pull/157

handful of users in paper-help over the last week or so

very hot @oak quiver

[oak quiver]

hey @small harbor

[spice temple]

Why do we need libx?

Shouldn't stuff be headless?

[small harbor]

not for paper

paper depends on a headless jre

[spice temple]

Ah fun

[small harbor]

these dependencies should already be in ubuntu and docker image containers & probably minimal installations

but ubuntu being ubuntu

[fair river]

Damn Michael moving fast

[oak quiver]

Should promote the usage of container-ized envrionments on our end instead of updating the nth os command 😴

[eager plover]

Well, xrender1 is needed for the graphics stuff in java, I think that maybe you can co-oerce it to run prperly without that, but, by default, the thing things that it's in a headed environment and tries to init the graphics stuff and blows up

pushing contanised environments would be good if there wasn't such a "and now we're going to introduce you into docker fundimentals to start a basic mc server!"

[supple comet]

maybe this goes against the whole ethos of like docs and stuff but maybe have a one liner of getting ubuntu setup with docker / paper wouldn't be horrible

[eager plover]

There is no one liner

We don't ship a container image you can do that with

[pale sedge]

I want setup a bungeecord server, uh it's possible like i have 2 server 1 Survival Lobby 2 Survival World, i want connect the 1,2 servers means same data like Multiverse Core Uhh? Like Its Possible?

[eager plover]

This channel is for discussion documentation; and you can't share worlds between servers, sharing config files is generally hit and miss, etc, etc

[eager plover]

https://docs.papermc.io/paper/dev/getting-started/paper-plugins#classloading-isolation - seems cludgy and confusing

[radiant summit]

https://github.com/PaperMC/docs/pull/143
Waiting for suggestions, criticism, etc.
reply in PR please

[eager plover]

I’m concerned about your commentary on BukkitRunnable

They themselves are not deprecated, shoving them directly into the scheduler yourself is, because that breaks how those things work

[radiant summit]

I mean the methods on the scheduler are deprecated

[eager plover]

Yes, because you don't schedule BukkitRunnables like that

you use the methods on BukkitRunnable

idk what you mean by "calling static stuff"

[small cape]

They mean that the implementation of BukkitRunnable's scheduling methods rely on the Bukkit singleton

I believe*

[radiant summit]

I mean I've never liked that but I guess what cat said is true

still it's kinda a weird way to do it instead of just making a regular Runnable and if you want so bad Bukkit.getScheduler()

[small cape]

Well, truth be told, BukkitRunnable doesn't seem to belong with the rest of the scheduling API. It is a superfluous convenience class whose essence seems to demonstrate to new plugin developers how the scheduling API works while easing them into it with a readily-usable approach to self-cancellation and choice of scheduling context. If this were any API other than Bukkit where developers had a generally higher level of knowledge, I suspect it may have not been added.

This is not to say BukkitRunnable is wholly unhelpful for these purposes, or that it is bad to provide convenience APIs, or that new plugin developers need all be experts in their domain. However, I do wonder if newcomers would be better suited to simply using Runnable and Consumer<BukkitTask> as these seem more universally adopted, widely applicable concepts and therefore more conducive both to use of the BukkitScheduler and for future learning purposes.

[echo canyon]

🤔

[eager plover]

I mean, I just primarily disagreeing with the notion that was said around BukkitRunnable, they're not deprecated in any manner outside of the dumbness on the scheduler to avoid people doing a dum; concepts like Consumers have long been a mystical thing to newbies of the API, pointing to them ofc makes sense, but, I don' think disregarding BukkitRunnable is a good move in terms of proper documentation, especially for people to cross reference; say, they picked up some random plugin and wanna understand stuff; yea, the javadocs should go over that, but, javadocs scurry

[hot flint]

Is there a list of APIs for Papermc

[eager plover]

Not really

like, we have 100s of API additions over the top of spigot

Minidigger tried to create a thing in the past but it was just generally an unmangable task, especially with the number of patches

[hot flint]

okay thx

[split hatch]

I don't see paper 1.8.9 server

can anyone help i wanna make a bedwars server like hypixel

[fair river]

First of all, you are in wrong channel.
Second, chatGPT isn’t a very good source of technical infos.

Third, Hypickle has their own in-house software that’s not public so technically speaking you cannot make a bedwar server like Hypickle.

[split hatch]

Oh im really sorry I didn't notic that

thanks for helping me sir

i there any advice for me to make a bedwars server like what version should i Use Please @fair river

🥺🥺

[scenic gull]

Ask for help in the correct channel

[ivory dirge]

I might just be having trouble finding it because I tend to do that, but is there any info on the hardware requirements/recommendations for paper?

[serene vault]

That is missing from the docs, yes

[young matrix]

https://minecraft.fandom.com/wiki/Server/Requirements/Dedicated

it's perfec

[south thunder]

General recommendations are: a SSD, a modern CPU with high single-threaded performance (more commonly, desktop CPUs) and enough RAM for your server type and amount of players. A decent starting point for RAM, i.e. for a very small server, is 4GB

[radiant summit]

#paper-dev

[still apex]

https://i.imgur.com/Fzgoedi.png

[neon atlas]

@neon epoch do we care enough to update the troubleshooting docs

[00:00:00] [Paper Watchdog Thread/ERROR]: --- DO NOT REPORT THIS TO PAPER - THIS IS NOT A BUG OR A CRASH - git-Paper-366 (MC: 1.19.3) ---
and
[00:00:00 WARN]: java.lang.RuntimeException: Server attempted to load chunk saved with newer version of minecraft! 3218 > 3120

[still apex]

yes, that's a veyr big issue

[neon atlas]

yea not really xD hence why I ask

[neon epoch]

Yeah i figured it could stay like that :P

[neon atlas]

is

---
slug: /configuration
---

# Configuration

:::note

This guide currently only covers per-world configuration in `paper-world-defaults.yml`. Information
about general configuration will be added in the future. In the meantime, please refer to the
information in the [1.19 announcement forum post](https://forums.papermc.io/threads/paper-1-19.344).

:::
``` still applicable

I mean, it covers the paper-global config now as well

[neon epoch]

it does?

oh, on the other page

ugh, why is there a Configuration page, and then a Paper Global Config and Paper Per World Configuration and Paper System Properties

[neon atlas]

One is the intro on how to configure your server

[neon epoch]

The contents of the configuration page is literally just explaining the inhertance

[neon atlas]

yea

that is the point of it

you learn how config works there

and then the specific config values you learn in the references

[neon epoch]

eek, I feel like that Configuration should almost be a dropdown for the rest of the stuff

It just feels weirdly disconnected

@young matrix Hi - could you give https://github.com/PaperMC/docs/pull/172 a look please? Just to check i followed the docosaurus guide properly

[ocean void]

FWIW I don't think sulu can approve PRs anymore ever since he stepped back.

[neon epoch]

Yep, spoke to mini in vc though and he reccomended getting their input as noone else has touched them for a major version bump

[spice temple]

while not officially on the team anymore, sulus input is still highly appreciated and valuable

[fair river]

Sulu is shadow core team confirmed

[ocean void]

Oh yeah absolutely.

Just wanted to make sure the expectation was there. We love sulu.

[neon epoch]

@neon atlas

[neon atlas]

so leave the properties in References but move config up into the configuration itself ?

Might be worth its own PR honestly

[neon epoch]

It would be

[neon atlas]

ye

wouldn't mind the change, tho I also see how it makes more sense in reference

[neon epoch]

It could all be in reference, or in How-to

it doesnt really matter either way

[neon atlas]

Yea I mean, How-To is supposed to How-To guides you can read

having the giant files in there is meh

[neon epoch]

Would look something like that

[neon atlas]

can we not host the "intro to configuration" in the Paper Configuration part ?

dis part

[neon epoch]

not quite sure what you mean

oh i think i know what you mean actually

[neon atlas]

Like, top of the category

[neon epoch]

so just shove what was in “configuration” into that

[neon atlas]

Yea

[neon epoch]

yeah could do

[neon atlas]

so that page is an intro

[young matrix]

yeah looks good

[neon epoch]

Thanks for looking 🥰

[young matrix]

also for that anti-xray pr, I never wrote down the seed/coordinates I used to make that image so whoever redoes it will have to do all four options

[neon epoch]

oh lol, yeah dont worry about it 👍

[fair river]

Thanks for adding those

[neon epoch]

Ok, both my docs PR's are ready for review/merge:
https://github.com/PaperMC/docs/pull/172
https://github.com/PaperMC/docs/pull/173

This updates the docs site to 1.20 and also refactors the locations of the paper configuration pages.

The movement of the configuration page does also include the proper vercel redirect

[sharp pivot]

<@&748618676189528155>

[neon epoch]

I have updated the Anti-Xray images:
https://github.com/PaperMC/docs/pull/175

[neon epoch]

NVM, its a discord issue @neon atlas

some REALLY old caching

[neon atlas]

a small indie company

[neon epoch]

Yep, seems like that gets said more and more as of late...

[hasty mirage]

Is it safe to set up my server on 1.20?

[still apex]

wrong channel

[hasty mirage]

Which one?

Ow nvm.

[still apex]

#paper-help likely

[hasty mirage]

Alr.

[fierce onyx]

In the time you said wrong channel you could have answered his question

[still apex]

could've

[hasty mirage]

Sir is not so happy today.

Friendly support.

[fierce onyx]

I need answer to that question aswell.

[spice temple]

You realize you are the 1000th person today and powercas is just a community member like you, stuff is getting tiring you know

[fierce onyx]

Well if it is a FAQ, where is it easy visible?

[hasty mirage]

Every member is a member right? Or are we just numbers now?

That comment make no sense.

[spice temple]

Experimental build are out, they seem to work for people, your milage may vary

[hasty mirage]

I've read something wrong, and it's fine to correct me on it, but on a normal way like he wants to get treated.

[spice temple]

They are not somebody paid to help you, they are not even affiliated with paper, they are just trying to be helpful and friendly

[hasty mirage]

"Hey rambomine, this is the wrong channel. In #paper-help you can ask your question."

[fierce onyx]

What has that to do with us exactly?

[hasty mirage]

That would be a normal way to ask me.

[hasty mirage]

I understand, but in that case he could've said nothing.

If he's not a staff, who is he to correct me on a unfriendly way.

[spice temple]

He did point you to the proper place, mission accomplished

[small harbor]

my brother in christ don't make it a pointless discussion

[still apex]

wat

[hasty mirage]

And I point him to the fact the he is not friendly.

[small harbor]

take the answer or leave it

[fierce onyx]

I did not have got an answer yet

Can you provide me with an answer? 🙂

[small harbor]

if you ask it in the right channel, sure

#paper-help

[hasty mirage]

I take it, with a side node.

[fierce onyx]

Thank you.

[neon epoch]

@last bear - for some reason my PR you just merged built in testing but Prod has failed - the issues are addressed in my 1.20 PR though if you wanna take a look at that? Sulu gave it an un-official approval

[last bear]

Huh dank

[neon epoch]

Yeah i see the issue, its fixed in my other PR but it somehow managed to compile in both dev and my PR preview

just sheer will i suppose

[last bear]

Keeping docs of old major versions sure is something, but idc for now

thanks

[neon epoch]

wow who beat me to the @mods

[mental sleet]

(648d79aa97e40854add6783d) // @shell olive (@healthe_ / 722987518487822370) has been banned by @spice temple (134340832093405184)
Reason: scam

[burnt ice]

Error: Node.js version 16.x has reached End-of-Life. Deployments created on or after 2023-08-15 will fail to build. Please set Node.js Version to 18.x in your Project Settings to use Node.js 18.

;-;

[spice temple]

Ok but EOL is a month after that? Lol

And the original EOL was April 2024

[young matrix]

for one of the core team people, that isn't in github. should be able to change on https://vercel.com/papermc/docs/settings (ctrl+f "node.js".)

[young matrix]

Old API is no most likely not functional ...
On the API roadmap page

[spice temple]

Changed to 18

[sharp pivot]

<@&748618676189528155> bot ^

[marble lava]

How do I download the 1.19 paper version? I searched a lot and couldn't find it.

[ocean void]

Click the link for old versions on the downloads page.

[outer elk]

To download old versions of Paper, go to the build explorer: https://papermc.io/downloads/all. Note that old versions are completely unsupported and contain numerous bugs/exploits.

[sharp pivot]

This is not a support channel, go to #paper-help

[kindred talon]

It wasn't a support related question, I thought that was correct here, ok I'll post the question there thanks

[steady fulcrum]

This channel is for discussing the paper documentation

[tepid condor]

is there any documentation for the usage on the Folia stuff added to paper a bit ago, or is that TODO?

[fair river]

It’s already on folia readme

https://github.com/PaperMC/Folia#readme

[neon epoch]

people who have access to vercel- i think bumping node has broken yarn as preview is failing

[spice temple]

Urg

Can't look rn

Guess dep update is needed or something?

[eager plover]

Looks like a vercel bug

➤ YN0001: │ Error: While persisting /vercel/path0/node_modules/.yarn-cache/@fec-remark-a11y-emoji-npm-3.1.0-12195b44b4-8dc370c984.zip/node_modules/@fec/remark-a11y-emoji/ -> /vercel/path0/node_modules/@fec/remark-a11y-emoji ENOENT: no such file or directory, scandir '/vercel/path0/node_modules/.yarn-cache/@fec-remark-a11y-emoji-npm-3.1.0-12195b44b4-8dc370c984.zip/node_modules/@fec/remark-a11y-emoji'

[eager plover]

I tried doing a dep update, either it's a vercal bug or I'm not a node person (I mean, I know I'm not the latter, but, maybe both?); need somebody whose more familiar to tell me what to do,only one I've got is disabling the build cache, which, might be what it needs for now

[spice temple]

Maybe we can nuke the cache?

[eager plover]

I already tried that

Toyed with the env variabes, it ended up coming up with some similar kind of error, and so I just rolled stuff back and moved on

[outer elk]

https://docs.papermc.io/paper/aikars-flags

-Xmx controls the amount of heap memory assigned to the JVM, this does not include other memory used by java, or native memory used by other libraries such as netty (for networking) or SQLite. Please do not allocate all of your memory!

https://github.com/PaperMC/Paper/issues/895#issuecomment-372175216

[fair river]

@charred crypt we have #bot-spam for the usage outside of a discussion. This channel is reserved for people with document supports.

[neon epoch]

https://vercel.com/olijeffers0n/paper-docs/8Mzs1pKXcexjqGgUBPVaCb8Nywuf IDK what sorta configs you guys have on your docs. I build mine, and then updated to node 18 and then rebuilt and they are absolutely fine. Must be a config issue with your project

Specifically:

Running "install" command: `YARN_CACHE_FOLDER="$(pwd)/node_modules/.yarn-cache" yarn install`...

Looks odd

[eager plover]

we have like an environment variable

I tried disabling it and it still kept tryna do that

[neon epoch]

maybe disable it and then create a dummy PR to see if it needs more of a kick up the ass

[eager plover]

huh, it appears to be working again? o.O

[neon epoch]

I cant see what you are seeing so maybe

[eager plover]

I saw one of the PRs that failed earlier now build

trying another one

yea, working now

[neon epoch]

Yeah, looks like removing the Environment variable just took a while to propagate or whatever

Wait lol

that failed

[eager plover]

The one I just rebuilt is an issue in their PR

[neon epoch]

That looks like owens fault tho

yeah well, looks fine apart from owens broken pr

[terse magnet]

where can I get the openapi document definition of the hangar api ?

in json or yaml format file

openapi: '3.0.3'
info:
  title: GreetingService
  version: 1.0.0
servers:
  - url: https://example.com/api
    description: Example service deployment.
  - url: http://127.0.0.1:8080/api
    description: Localhost deployment.
paths:
  /greet:
    get:
      operationId: getGreeting
      parameters:
      - name: name
        required: false
        in: query
        description: The name used in the returned greeting.
        schema:
          type: string
      responses:
        '200':
          description: A success response with a greeting.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Greeting'
components:
  schemas:
    Greeting:
      type: object
      properties:
        message:
          type: string
      required:
        - message

just like this file

[formal warren]

https://hangar.papermc.io/v3/api-docs.yaml

[terse magnet]

thx very much

[terse magnet]

is this version v3 for the online hanger api?

[formal warren]

This is the yaml file from which https://hangar.papermc.io/api-docs is generated

(you can also find the file yourself by just looking at the network requests of your browser when visiting the above mentioned URL)

(or by taking a look at the source https://github.com/HangarMC/Hangar/blob/staging/frontend/src/pages/api-docs.vue)

[spice temple]

It's v3 of the generator

It's a well known url basically

[terse magnet]

should I use the browser developer tool to find the api_doc link?

[spice temple]

No, any oas3 will have that url

[terse magnet]

I got it

thank you buddy @spice temple @formal warren 😘

[formal warren]

Ah, well honestly I don't really know OpenAPI 😂
But good to know, thank you

[neon epoch]

@burnt ice if you review within the next 5 seconds I will give you a free candy bar https://github.com/PaperMC/docs/pull/183

⏲️

Some of the stuff might be wrong - its what I yoinked from the #dev-announcements

[burnt ice]

@neon epoch The admin guide might need to be updated too

https://docs-6ts5lrt57-papermc.vercel.app/paper/reference/paper-plugins

[neon epoch]

with what

[burnt ice]

the circular dependency stuff

that isn't an issue anymore, paper auto trims it

[neon epoch]

so i can nuke it

[burnt ice]

@neon epoch At least that section, probably?
But I think that it still can cause issues for paper plugins, since at least those don't get trimmed. I would move that to the dev section.

also, required is true by defualt

Dependency declaration is specified a bit differently than Bukkit plugins, as you are able to define if a dependency is required during bootstrapping. This means that any bootstrapping logic for your dependencies will be run before yours is run.

Can probably be adjusted and reworded a bit.

and the Load Order Logic Split section

[neon epoch]

i did reword that a bit

[burnt ice]

# Suppose we require ProtocolLib to be loaded for our plugin
ProtocolLib:
  required: true

This is misleading, you'd want load: AFTER

[neon epoch]

facts

[burnt ice]

Infact, I would delete this phrase entirely.

[neon epoch]

Dev page?

I think get rid of the image cause its for devs