docs-website

[supple comet]

Ok

[still apex]

Maybe this should be renamed to Configuration if it's also going to include Bukkit & Spigot? https://i.imgur.com/gYzns60.png

[lilac edge]

@neon epoch is this hidden div actually needed? google search seems to see the rendered config just fine

• Google Search Rich Result
• Google Web Cache Text (Text-only version selected)

haven't checked other search engines, so maybe it applies there?

[neon epoch]

Yeah fair enough, well thanks ☺️

Yeah basically @supple comet i am aware the docs search doesn’t really work, i just am struggling to find the time and solution to investigate this. Its gonna require manually adding search results via typescript i think

[neon epoch]

i’m pretty sure the data you are seeing is the hidden div. this is because the react components are not created yet in the plain text view google sees, feel free to prove me wrong as this was a like “it will definitely work” solution from someone who hasn’t touched SEO before

[neon epoch]

however, control + f is not broken and this was something i refused to hijack so you can search just like normal

[lilac edge]

if you click on the "Google Web Cache Text (Text-only version selected)" hyperlink in my message and inspect element, you'll see that the generated components are visible

looks like the hidden div is used by SEO for the description text, so it's probably still useful for now while the descriptions are all hidden by default

[neon epoch]

basically why it is there

[lilac edge]

ngl i was surprised to see the generated components formatted so well in the text-only version

[neon epoch]

Yeah ahaha

[lilac edge]

basic little button to test

[neon epoch]

Looks good

[still apex]

@neon epoch

[neon epoch]

i did it

[still apex]

just saw

[neon epoch]

[still apex]

right after i sent that

[neon epoch]

i tried adding new things to the docs search but im having API issues

[neon epoch]

i like this idea though, feel free to PR it

[lilac edge]

was planning on it :P

just need to make sure i'm not fucking up anything with how i'm passing the states through

[neon epoch]

maybe if you make it sticky to the top right of the code box and then it will scroll down with the page. but then only display it when you get near it like the # copy things

if possible that is

[lilac edge]

anything is possible

what i had in mind earlier

but i'm ultimately against it cause i feel like we hide enough things as is

[neon epoch]

🤷‍♂️

[lilac edge]

might be cool to do the sticky stuff on the section keys as well

for now i'm just gonna keep it simple

[lilac edge]

silly button all ready to go https://docs-2acfniog8-papermc.vercel.app/paper/reference/world-configuration

[neon epoch]

sticky stuff was attempted but the <pre> messed it up

[neon epoch]

Looks good, just idk if you could fix the button width so that it doesnt change when clicked, and you also need to invert the colours for light mode

[lilac edge]

forgot about light mode

[lilac edge]

should be good now

there's no buttons used anywhere in the docs so i had to make up my own colors for light mode - feel free to change that at your leisure

[neon epoch]

there is this weird behaviour when you click somewhere else than the button and it changes colour

[lilac edge]

technically that's working as intended? mobile hates colors that are set on hover

ooh i accidentally removed the color change on hover in dark mode

made the color change on hover more obvious in dark mode

[neon epoch]

Looks good

i’ll leave it as approved for a bit to see if anyone else has ideas, otherwise ill merge - thanks ☺️

[neon atlas]

https://docs-csmfyr62e-papermc.vercel.app/paper/dev/project-setup

compileOnly("io.papermc.paper:paper-api:undefined-R0.1-SNAPSHOT")

[spice temple]

Interesting, since it does make the call properly

Which branch is that from?

[neon atlas]

an outdated deployment, thank you github

[spice temple]

Since I can't see that deployment in vercel

[neon atlas]

its what github smacked at me when I clicked the deployment button

I get the correct one now, weird, looks functional now tho

[supple comet]

Ok thank you

[sharp pivot]

https://docs.papermc.io/paper/migration#from-vanilla downloads should be without the s here

[still apex]

eh

maybe have it link to the paper one

right now it goes to the download__s__ page

[sharp pivot]

the downloads at the start of the line

[still apex]

oh that one

[neon epoch]

lovely release

[neon epoch]

thanks

[neon epoch]

@lilac edge

it overlaps text on mobile :)

[jagged pecan]

im not sure if my changed permissions.yml info is ok, dunno if paper wants to endorce anything specific, or anything else
i havent looked fully into permission.yml format, i could also do a pr to add docs on that format if intrested (and maybe commands.yml)

[neon epoch]

those two files are gross

[jagged pecan]

yeah

[lilac edge]

i'll adjust it later this afternoon

technically works as intended though

[neon epoch]

Yeah, sounds good

[spice temple]

Maybe just remove a bit padding on mobile

[jagged pecan]

oh + help.yml

[still apex]

is that even used

[neon epoch]

i don’t even know what that is

[eager plover]

help.yml exists for bukkits help command

[jagged pecan]

im not sure anyone uses it for the custom sections atm

[eager plover]

I think it's just one of the many forgotten systems of bukkit

[jagged pecan]

https://bukkit.fandom.com/wiki/Help.yml#general-topics

like the help: rules example

most use another plugin or smth

[fair river]

For ease of access, I think having it on our site is good. Fandom is literal cancer when opened without ad blocker on mobile. Lol

[spice temple]

We ultimately want all relevant documentation for running a paper server on our docs

Maybe we can even have some cool landing page with a folder structure and links to the individual pages to explain what each file does

[eager plover]

Still kinda wish we went with a wiki

but, yea

[spice temple]

Well, maybe don't need a whole page for stuff like the whitelist file or the userlock

Wikis are complicated cat

And this gives us more control

[fair river]

Is this even possible on the stuff we currently use?

[spice temple]

Both technically and content wise

[eager plover]

my heads too spinny but the layout of the side just always makes me sad

[jagged pecan]

:evil-laugh:?

[eager plover]

the lack of stuff like tags is weird

[fair river]

Maybe like a folder-like UI showing all folders for user to click to explore

[spice temple]

What would tags to?

[spice temple]

Yeah, doesn't need to be fancy either

[eager plover]

so you could pull up all pages related to say, files on the disk

Like, the layout of topics just feels cludgy

[jagged pecan]

sound cool. not sure if you would deal with customisable locations (flags, or in other config files like permissions.yml), or those in like world folders (like paper-world.yml)

[fair river]

(@ cat) That I agree, on top of that, search is being weird rn.

[eager plover]

Like, I often trip up on my own ass tryna look for dev/server docs to link to

[spice temple]

Well, we can reorder stuff however we like

https://nuxt.com/docs/guide/directory-structure/nuxt

This is how nuxt people explain their folder structure for example, but I am missing a landing page here

[eager plover]

part of my love with wikis is you can just tag stuff and tell people to figure it out

You know, when I was younger, I used to think that my sister was weird af, because basically every single summer she'd end up reorganising her entire bedroom layout for no reason other than she was bored of it

but, now I feel the same way with our docs

[spice temple]

Reordering our docs when new stuff gets added is just fine

Just need to redirect old urls

[neon epoch]

search is fucked but i tried tinkering with it this morning and i kept getting unauthorised errors when i am pretty sure i had the right key

[fair river]

we gonna put in overtime for Ollie now if we gonna do that Mini

[jagged pecan]

its weekly crawl, right?

[neon epoch]

yessir

[spice temple]

Maybe I can help looking at search

This week or so

[eager plover]

somebody linked something, you can toss in some thing to the search providier thingy which lets you add custom links, etc

[neon epoch]

yeah, the only thing is i think the crawl overwrites all objects so then we would need to time it so that after the crawl we then insert all our stuff and it just sounds janky

[neon epoch]

did they, where?

[eager plover]

I, er, don't remember

[neon epoch]

Huhhh what did i miss

[eager plover]

and i'm too spinny to look

[jagged pecan]

so im looking at the search for config stuff, it looks like since its not wrapped in <p> tags
it might be able to add div to the docs search config, but idk if that would overmatch

[spice temple]

Can't we add some class to the config stuff and make the crawler consider those too?

Just did that at work with another search provider, added data dash attributes

[eager plover]

Yes, that was the thingy

somebody linked a link to he api for that, either in here or maybe in internal somewhere, idr

[jagged pecan]

it uses css selectors right? so classes should work

[spice temple]

Data dash might be clearer

(can still write selectors for them)

[neon epoch]

I think we can just modify the agolia record extractor

[eager plover]

there was a way to inject into that is what I recall being linked

[neon epoch]

i mean you can just write js in it

why do our crawls happen at 10:06

[eager plover]

https://docsearch.algolia.com/docs/record-extractor/

[neon epoch]

yuh that was the page i was looking at

[eager plover]

annnnd my laptop has stopped charging again

[neon epoch]

i mean our current one is a bit fancy

seems like the records do contain the stringified version of the yaml

[eager plover]

See, eternity wa showing his in search history he could see some of that stuff

but, when I tried it failed

the lack of spaces in that info though

is that an issue?

[neon epoch]

i think that might have been historical

It adds them now, but they have very little info about them

[lilac edge]

is using conditional rendering vs hiding the element using css a design choice here? i feel like keeping it hidden in the dom might help with the search issue

[jagged pecan]

is there anyway to disable ligatures in the config? im making a commands.yml doc page

(the last 2 entries)

[neon epoch]

Done it, just need to make the links line up @fair river

[jagged pecan]

nice!

how does it work for lists?

[neon epoch]

yeah currently if you click it, it doesnt link to the right place

Bad lol

its live btw

you can test

[jagged pecan]

yeah i just realised that

click to expand

so i guess the hidden default entries arnt indexed

yeah doesnt look like it

and that screenshot was the wrong size

good job me

[neon epoch]

well it crawls the keys, and defaults

[lilac edge]

does adding a backslash to the character not work? e.g. \>- or >\-

[jagged pecan]

nope

i could probably use a nbsp

[lilac edge]

might need to put like 2-3 backslashes since the yaml is being parsed from a string

[jagged pecan]

well it breaks it up lol

[neon epoch]

recordExtractor: ({ url, $, helpers }) => {
  // priority order: deepest active sub list header -> navbar active item -> 'Documentation'
  const lvl0 =
    $(
      ".menu__link.menu__link--sublist.menu__link--active, .navbar__item.navbar__link--active"
    )
      .last()
      .text() || "Documentation";

  return helpers.docsearch({
    recordProps: {
      lvl0: {
        selectors: "",
        defaultValue: lvl0,
      },
      lvl1: "h1",
      lvl2: "article h2",
      lvl3: "article h3",
      lvl4: "article h4",
      lvl5: "article h5, article td:first-child",
      lvl6: "article h6",
      content:
        "article p, article li, article td:last-child, article a.with-value",
    },
  });
}

This is our record extractor config, problem is that the link is not correct because we use custom hrefs. It might be essentially down to setting some breadcrumbs or something that can be extracted (ie the hash) so that we can link to articles properly. Im gonna log off for tonight though in a sec

also i have a PR that changes the A tag to span so yeah

[jagged pecan]

yet another pull, sorry :) https://github.com/PaperMC/docs/pull/233

[fair river]

greatly appreciated for the work

[neon epoch]

Erm, not any particular reason although i don’t think it helps with search honestly

it might be wise to just set it as hidden and then we could just remove the duplicated hidden thing in the background and save some small amount of bandwidth lol

[jagged pecan]

@neon epoch for the last review comment, look at the bottom 2 entries here

[neon epoch]

oh right, i see what you were talking about. this can’t be escaped?

[jagged pecan]

not anything i tried, since its a font thing and the characters are next to each other

[neon epoch]

that’s a pain

[jagged pecan]

an invisible character between them should work, but creates more hassle for future maintenance etc imo

[lilac edge]

it's not too bad - since i already have a class specified for the codeblock in my PR you could just move the styling there

that depends on which PR gets merged first though

[neon epoch]

probably urs - gotta navigate the pain of supporting mobile first tho ahah

[lilac edge]

so annoying :P i really want to avoid adding mobile-specific styling when it's such a small thing

that's a personal thing though

[jagged pecan]

how about bukkit-commandsyml-configuration as the slug? or should it explicityly say outdated

[neon epoch]

i liked the idea of the folder thing for configuration docs. Might look into making something for that tomorrow

[neon epoch]

it shouldn’t say outdated, idk something like commands-file-configuration

[lilac edge]

just found a minor bug with it anyway so kinda glad the merge was delayed

[jagged pecan]

if the urls are changing soon it probably wont really matter (id assume they would be named more after their filename? idk)

[neon epoch]

why are urls changing

[jagged pecan]

oh sorry i thought you meant adding a sub-path to the url

like reference/config/bukkit-commands, reference/config/paper-global

how is
What commands to use the vanilla versions in command blocks, instead of bukkit or plugin provided versions. ->
Which vanilla commands should override those provided by bukkit or plugins in command blocks.

actually im still not 100% happy with it

[neon epoch]

oh yeah they probably should do that lol, didn’t realise they didn’t already. I’ll keep these prs in the queue until we get something more solid laid out for a structure to them

sounds pretty good

definitely better

[jagged pecan]

i think the to -> should in my edit also helped a lot

[lilac edge]

The vanilla commands to prioritize over those...?

[jagged pecan]

should i add the /config/ or /configuration/ to the urls in my prs now, before they are merged, so redirects dont have to be added later (exact path needs )

override -> be prioritised over?

[lilac edge]

be prioritized over sounds good to me

could probably omit in command blocks since that's implied by the config name

oh it's also specified in the second sentence, so yeah you could just omit it from the first sentence

[jagged pecan]

ive changed the second sentance locally already to Useful for compatability with adventure maps built for vanilla commands.

ive s/commands/command blocks

since it still makes sense, and i can remove it from the first sentence

[lilac edge]

so what does that description look like now altogether?

[jagged pecan]

ive just pushed, so it should appear in a sec
but

Which vanilla commands should be prioritized over those provided by bukkit or plugins. Useful for compatability with adventure maps built for vanilla command blocks.
Use the literal '*' to always use the vanilla version in command blocks.
By default, no commands are overridden.

[lilac edge]

doesn't that option also apply for commands used in datapack functions?

[jagged pecan]

uh ill check

its used in net.minecraft.commands.Commands#dispatchServerCommand

which i think is only called from BaseCommandBlock

so no, doesnt affect functions, only command blocks, command block minecarts

[lilac edge]

then s/compatability/compatibility is my only nitpick

made the button smaller https://docs-8otr7olt6-papermc.vercel.app/paper/reference/global-configuration

@jagged pecan just added this to my PR, you can omit it from yours

[jagged pecan]

👍

i am probably going to make these pages at some point in the future

permissions.yml
help.yml
server command line options

[spice temple]

Idk who said it but I agree, content should always use css to hide, it needs to be in the Dom, for various reasons

[neon epoch]

Yep.

[spice temple]

Oh I see that was already addressed

[lilac edge]

yuh

[neon epoch]

Yea and RE your comment mini, i was planning on fixing that when i tackle the agolia crawler properly

[spice temple]

Ah ok

[neon epoch]

for now the results don’t link to the right place, but they do show up

[spice temple]

Just saw it when inspecting them Dom of that branch

[lilac edge]

ollie have you looked into proper a11y support as well?

oh i see that's sort of acknowledged in mini's comment

[spice temple]

Proper a11y generally is pretty hard, but we can def do incremental improvements, especially if they also have side effects on SEO and our own search like this case

Oh docusarus nav already is pretty a11y friendly

With skip to content and all that jazz, nice

[lilac edge]

i'm thinking about the tab selection aspect of it - currently it highlights the hash hyperlink instead of the config nodes

ooh and it doesn't even do anything in regards to it except scroll the selected hash to the top of the screen

nevermind i think i got the functionality of spacebar and enter confused

wasn't there an a11y browser extension tool that helped validate accessibility?

ah lighthouse has checks for it

[lilac edge]

fixed with my recent PR

[jagged pecan]

should Players be capitalized or not?

i think consensus from other docs pages is no

[still apex]

it shouldn’t

[jagged pecan]

im also guessing vanilla should be capitalized, to match Paper and Bukkit

[radiant summit]

nope

I'd consider that a verb or something, not really proper noun

if someone wants to override me on that, sure, but correct it on every other page then lol

[jagged pecan]

to vanilla?

maybe not a verb

[radiant summit]

scratch that 'verb'

just, not a proper noun, it can be used for any original thing X which has some unofficial modification

[neon epoch]

do you mean adjective

[radiant summit]

yes I meant adjective but scratch it anyway

[neon epoch]

i would capitalise it

Vanilla
vanilla Minecraft

one is a noun, one is an adjective

[radiant summit]

overall docs are inconsistent with vanilla/Vanilla

[jagged pecan]

i can revert the one where i updated it for the spigot.yml pr if you want

[radiant summit]

keep it consistent to how it is in other configs then at least

I'd prefer not capitalizing adjectives though, but that may be inherited from me being Polish where we don't randomly capitalize stuff

In English You Can Capitalize Everything And Still Looks Good(TM)

[jagged pecan]

iT sTiLl LoOkS gOoD

[jagged pecan]

so what was the outcome? paper-world was inconsistant

12 lowercase 6 uppercase

not sure if any were in config keys

[neon epoch]

the only thing we really consistently capitalise is Paper

[still apex]

PAPer

[jagged pecan]

xX_PAPER_Xx

[neon epoch]

if paper was a 2013 minecraft account sure

i wanna merge 212, anyone have problem with that?

that’s the version placeholder one

[still apex]

link

[radiant summit]

Kenny-approved

[neon epoch]

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

[spice temple]

Can we like try that or whatever?

I don't fully understand it and don't have time to look into it

[jagged pecan]

like this?
https://docs-9bhpeeew2-papermc.vercel.app/paper/dev/userdev#adding-the-dev-bundle-dependency

[still apex]

does that also do it for velocity?

& folia etc

[neon epoch]

Try it, sure there is the preview and look paper project setup

it does velocity but i didn’t do it for folia because it doesn’t have anything that needs it

it’s mainly used for like gradle examples there

[spice temple]

How do you switch versions on mobile?

Ah, back to main menu

[jagged pecan]

did it get backported

into older docs version

[still apex]

https://github.com/PaperMC/docs/blob/28f8769906226b9acecca666eb6d4184253ecb48/src/components/VersionedJavaDocLink.tsx#L9 won’t this always use paper

[neon epoch]

lol

yeah ahaha

[neon epoch]

^ btw

[neon atlas]

[neon epoch]

i don’t think it works with velocity anyways cause the javadoc link is cursed

iirc it uses /velocity/3.0.0/ for 3.2.0

i guess i can add some logic for that tho, if velocity just take the major and then add two 0’s

[radiant summit]

except Velocity's "technically latest" is 4

💀

[sharp pivot]

and then there's also velocity 5

[still apex]

5

[neon epoch]

[neon epoch]

Fixed that

[jagged pecan]

blank default values seem to change to "N/A"

https://github.com/PaperMC/docs/blob/main/docs/paper/admin/reference/configuration/server-properties.mdx#L211

esp in server.properties where that is valid

[neon epoch]

yeah ill fix that

[jagged pecan]

actually looking at where N/A is used (like here)
should i move this to use it in commands.yml

lol discord chose the best parts of the image to show

[neon epoch]

looks fine tbh

[neon epoch]

Something like that what you were talking about @spice temple ?

it took like 10 mins so if you hate it its fine

it seems redundant

[radiant summit]

it's clearer than the sidebar tbh

and is easier access to what you actually want

[spice temple]

I wouldn't even limit it to config stuff, just all files, explain what each file paper creates does

Idk about that design

[jagged pecan]

personally, i would like some kind of lines down to clearly show scope

i think the rounded borders are too conflicting with each other

[spice temple]

Yeah, a normal ASCII art folder structure is good enough

[radiant summit]

lame

[neon epoch]

I mean something like this does look a bit boring, some variation of it though

[radiant summit]

we're not on IRC

[spice temple]

I take boring over overly fancy any time of the day

[neon epoch]

im kinda out of ideas

anyone feel free to draw all over it in paint of something ahaha

Just formatting the page makes it look nicer

https://paper-docs-1xfm3m1z4-olijeffers0n.vercel.app/paper/reference/configuration

[fair river]

Hell yeah!

[neon epoch]

do you mean like this @spice temple

[radiant summit]

also while Mini will be here, wanna settle sth? vanilla or Vanilla

[spice temple]

No I meant on the anchor

Plus, lmao, just saw that we nesting an anchor inside of an button again, that is bad

Somebody needs to figure out how to make a span tabable I guess

[spice temple]

(The span/button doesn't need a title since it has text inside)

[eager plover]

We generally use Vanilla as a noun

[radiant summit]

ugly

[neon epoch]

told ya

[neon epoch]

think i did it

also @lilac edge making the descriptions display: none has made them crawlable so nice job

[neon epoch]

more time wasted on agolia

i hate this ide so much that they have build into their site

What the fickity frack

[neon atlas]

mhmmm

looks solid

[neon epoch]

why does the text moooooooooove

[neon atlas]

maybe it wants to have a good time

[neon epoch]

[neon atlas]

[spice temple]

kek now the site is crashing edge (am at home now)

it needs to update anyways

still crashes, what the actual fuck

the second I open dev tools I get a status access violation

mmmh, the accessibility tree still shows it as # in firefox

[neon epoch]

🥴

[spice temple]

idk if the title attr is wrong but thats what edge wanted I think

somebody here blind or knows how to use a screen reader? 😄

[eager plover]

eeeerrrrrrr

[still apex]

https://chrome.google.com/webstore/detail/screen-reader/kgejglhpjiefppelpmljglcjbhoiplfn/related

[neon epoch]

this screenreader can see the titles of the tags

for this reason, im gonna mark this as functioning and merge

god screenreaders are annoying

[spice temple]

More annoying than not having eyes?

[neon epoch]

oh no, i absolutely do not envy them

[jagged pecan]

this was a pain finding the max effective growth rate https://github.com/PaperMC/docs/pull/221/commits/f8ac58af5fc39d786ebe912172c600c8c1d692df#diff-b72e9a80fa8fc7b2e30bd8a7022b2a83c52ed1edb1a2f3a85dadddaee1f8c576R340-R483

[neon epoch]

your CI failed

[jagged pecan]

yeah i fixed it

[jagged pecan]

#230 needs a little more review, as ive just had to fix the docs for paper world spawn limits, so i could correctly link it

[brazen moon]

you did way more than i thought for the growth modifier, but i think it's a little bit too much for the sugar cane / cactus and since those implementation are currently broken.. if you don't mind you can strip them and just keep the max here

[radiant summit]

Ollie why so fast

[sharp pivot]

I blinked and there was a review

[radiant summit]

our Documentation Expert

[neon epoch]

The backbone of papermc

nah, just right time right place lol

[jagged pecan]

for config versions, should i make another pr to add it into the paper configs?

[jagged pecan]

how are they broken? does that need documenting atm?
otherwise, should i just keep it to the max effictiveness, like the other plants?

[brazen moon]

since the implementation will change at some point in the future i don't think it's worth documenting a broken thing for now. (see https://github.com/PaperMC/Paper/issues/8544)

[jagged pecan]

alr pushed

[neon epoch]

nah not needed i don’t think

[still apex]

don't merge my pr yet pls ty can be merged / reviewed

[neon epoch]

the real question is what is deltapvp

[still apex]

what

[neon epoch]

idk your email popped up when i merged it

[still apex]

a domain that i own

i should probably set e-mail up on my other better domain

[neon epoch]

@spice temple - more like this?

idk whether to make non-linked files white

[jagged pecan]

missing

logs/
|- latest.log
|- <YYYY-MM-DD>-<n>.log.gz
version_history.json
world/
|- level.dat
|- level.dat_old
|- session.lock
|- stats/
|  |- <uuid>.json
|- region/
|  |- r.<x>.<y>.mca
|- poi/
|  |- r.<x>.<y>.mca
|- playerdata/
|  |- <uuid>.dat
|  |- <uuid>.dat_old
|- entities/
|  |- r.<x>.<y>.mca
|- datapacks/
|  |- bukkit/
|  |  |- pack.mcmeta
|  |- *.zip
|  |- */
|- data/
|  |- raids.dat
|  |- random_sequences.dat
|  |- scoreboard.dat
|- advancements/
|  |- <uuid>.json
plugins/
|- bStats/
|  |- config.yml
|- update/

[neon epoch]

i mean i kinda omitted a lot of that on purpose cause it’s gonna make the ui look shite

maybe if the folders are collapsed by default

[jagged pecan]

There should be infinite scroll and list all the possible regions

[spice temple]

Well, does anybody else even think this is a good idea in general?

Explaining every single file paper creates

[still apex]

every single one no, the “important” ones yes

[spice temple]

What is important to you?

[still apex]

¯_(ツ)_/¯

[spice temple]

My idea is basically having a thing where somebody can go to answer the question "what is this strange file doing here? Is it important?"

For most of these files that can be answered with a single sentence, so the tooltips are enough, for others like the proper config files we want dedicated pages

[still apex]

a tooltip works yes

[still apex]

thought you meant a dedicated page with this at first

[neon epoch]

i like the concept but just needed UI suggestions, i was just asking your opinion on it now really. I think tooltips for most files is enough, just gotta write them :)

[still apex]

.console_history too iirc

[jagged pecan]

I guess the Gradle run config doesn't use jline, so it doesn't get saved

[neon epoch]

again, that was a file i chose to omit but can be added if wanted

[jagged pecan]

Well you don't really want someone looking at docs to see if it's important, not seeing it, assuming it's not, and loses command history
(Although you would have to be pretty stupid to do that)

[neon epoch]

@radiant summit re https://github.com/PaperMC/docs/pull/212#issuecomment-1700357172

Im not really sure if it is worth it? The jar you download will have the build number in it anyways so you do have to rename it anyways? Up 2 u tho what do you think

[radiant summit]

Considering it's the guide for getting started people will save it with the name they downloaded most likely

So that command will exactly match then

[neon epoch]

nah it wont

it downloads with the build number

like paper-1.20.1-9 iirc

[radiant summit]

don't we have the build number?

[neon epoch]

[radiant summit]

then pointless

[neon epoch]

that would require seperate api calls and tbh, if you cant work out how to rename a jar file you shouldnt be running a server lol

[jagged pecan]

Still not a huge fan of "commands configuration" as a title, I feel like it makes it sound way more useful than it is... Not sure?
would something like alias configuration be better?
we had already established that "legacy" or "bukkit" commands configuration was bad, right?

[neon epoch]

See like "Bukkit Commands" is alight but it gives like the idea you are configuring the builtin bukkit commads

[jagged pecan]

hmm

[spice temple]

Why don't we use the file names as title?

[jagged pecan]

i just followed the existing paper world, paper global stuff ¯_(ツ)_/¯

[neon epoch]

Looks bad

[still apex]

Configuration Files?

Config Files?

Configs
Configrations

[neon epoch]

what?

[still apex]

for this https://i.imgur.com/8fAdGP8.png

[neon epoch]

that wasnt the problem lol

its the files

[still apex]

i know but if you rename it, then it might look better?

[neon epoch]

oh i see

maybe

[jagged pecan]

https://docs.papermc.io/paper/dev/event-listeners#event-cancellation
PlayerJoinEvent isnt cancellable

[neon epoch]

hehe lol

[burnt ice]

@neon epoch CLASSICC

[neon epoch]

😤😭

[south thunder]

Would some "common issues" be welcome under the basic troubleshooting docs, even if they're not Paper specific, but often appear in #paper-help ? E.g. "Timed out" & some networking issues, troubleshooting farm stuff, people with netty complaining due to plugins messing with packets, etc

[eager plover]

welcome dunder

[south thunder]

Bad cat

[eager plover]

but, yea, a common FAQ (pronouced fack) would be an idea

[jagged pecan]

is there any reason it says forced hosts arent compatable with srv records in velocity's faq
https://docs.papermc.io/velocity/faq#my-forced-hosts-are-not-working

[eager plover]

Because the client sends the record that the SRV resolves to

[jagged pecan]

i was looking into it more to make proper docs for it, and it should just work ™️

[jagged pecan]

not anymore, has it changed recently?

[eager plover]

ergh, no idea

I recall them changing the behavior a few versions ago

[jagged pecan]

    public void pingServer(final ServerData server, final Runnable serverListUpdater) throws UnknownHostException {
        ServerAddress serverAddress = ServerAddress.parseString(server.ip);
        Optional<InetSocketAddress> optional = ServerNameResolver.DEFAULT.resolveAddress(serverAddress).map(ResolvedServerAddress::asInetSocketAddress);
        if (!optional.isPresent()) {
            this.onPingFailed(ConnectScreen.UNKNOWN_HOST_MESSAGE, server);
        } else {
            final InetSocketAddress inetSocketAddress = optional.get();
            final Connection connection = Connection.connectToServer(inetSocketAddress, false);
            this.connections.add(connection);
            server.motd = Component.translatable("multiplayer.status.pinging");
            server.ping = -1L;
            server.playerList = Collections.emptyList();
            connection.setListener(new ClientStatusPacketListener() { ...SNIP... }

            try {
                connection.send(new ClientIntentionPacket(serverAddress.getHost(), serverAddress.getPort(), ConnectionProtocol.STATUS)); // <-- HERE uses the server address directly from the ip screen
                connection.send(new ServerboundStatusRequestPacket());
            } catch (Throwable var8) {
                LOGGER.error("Failed to ping server {}", serverAddress, var8);
            }
        }
    }

relevant client code

[eager plover]

that's the pinger

what does the actual connection logic do?

[jagged pecan]

it just opens the channel afaik? the client intention packet is what is used as the vhost right?

[eager plover]

that thing purely acts to ping the server

idk if the logic for actually connecting is different

[jagged pecan]

oh right i misunderstood

course

right yeah it does use the hostname from the resolver on connect

im surprised the logic is split like that, using 2 different things for the client intention packet in status vs login

[jagged pecan]

change version for for status = 21w19a (for minecraft 1.17)

also is the first version to move to java 16?

[spice temple]

@neon epoch hello mr master of docs, I need a docs page where we can have generalized paper server admin faq stuff, so that I can add a question or two for https://github.com/PaperMC/Paper/pull/9692
what do you think would be the best location?

[neon epoch]

Could just have an “FAQ’s” page under paper/admin/misc

also, 😂

[spice temple]

now your laughing, but you will have to review my broken english later 😄

[neon atlas]

wait, we are going to have an option to bypass minimum java version check ?

when is that ever useful

[spice temple]

paperweight checks it too

I just added it for code cleaness or whatever, lol

[neon atlas]

I mean, anything below 17 will just run right into exceptions on server start

[spice temple]

yeah, paperweight catches that

updated the message there too to link to the docs

[neon atlas]

do you mean paperclip ?

[spice temple]

sorry, yes

[neon atlas]

or am I havign a-

ah

😅 okay

[spice temple]

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

[neon epoch]

looks good other than the couple of things i commented

[spice temple]

addressed

[neon epoch]

3 commas and a word change and that’s good to merge imo

didn’t pick up on them on my skim read the first time

[jagged pecan]

personally i would have the url as https://docs.papermc.io/paper/faq, (rather than having "misc" in the url) but idk

[neon epoch]

i’m against this just cause it makes maintaining the structures of the folders poor

ik what you mean, but i think it’s better to leave it

[jagged pecan]

the config stuff atm doesnt have the subdirectory in the url iirc

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

[spice temple]

url we can do whatever technically I think

so yeah I guess it makes sense to drop the misc from the url

[jagged pecan]

the urls vs files vs categories are odd atm
like /paper/dev/event-listeners
is paper -> Development -> API -> Event Api -> Event Listeners

[neon epoch]

yeahhhhhhh they really need standardising but shrug

[spice temple]

we cant ever change urls

[jagged pecan]

and all the administration stuff doesnt have /admin/ in the url like dev an misc do

[neon epoch]

Huh? yeah you can but it requires redirects

[jagged pecan]

we have before https://github.com/PaperMC/docs/blob/main/vercel.json#L6

[spice temple]

yeah, thats what I mean

[neon epoch]

ah yeah you can’t really just randomly change it

https://github.com/PaperMC/docs/pull/240/files#r1319980708 mini?

wow that’s a big mini pfp

[spice temple]

theres a with missing

[jagged pecan]

need want a github action to get a list of current urls in HEAD and HEAD~1 (or branch before merge), compare and makes sure it only ever grows lol
(and then you could also do whatever docs urls are new in a pr directly)

[neon epoch]

huh? that seems kinda pointless

[brazen moon]

Ollie, you forgot to update the description when you changed the event in the doc here: https://docs.papermc.io/paper/dev/event-listeners#event-cancellation: "The above example will cancel the event, meaning that the player will not be able to join the server"

[neon epoch]

damm, couldn’t even find it the first time to change it. not surprised i missed it lol - thanks ☺️

[neon epoch]

Ugh idk how i deal with the CSS here to make the (i) hide under the coloured bit

[lilac edge]

z-index?

do you have a PR going for that or is it all local

[neon epoch]

new configuration page thingy

z index is what i was trying but i essentially have this invisible area around the box where i still want the box to be open and not close, but i want to be able to use other (i) tags through it which is the problem

[lilac edge]

might be an impl issue

could you push what you have so far? i'd like to take a look at it sometime after i wake up

[neon epoch]

iirc i did last night

yeah, looks like my 13 hrs ago commit mentions the z index

[still apex]

why does https://docs-nuk8618hb-papermc.vercel.app/paper/dev/custom-inventory-holder use like 8 spaces instead of 4

[radiant summit]

because it's tabs?

the only character you should use for indentation?

[spice temple]

No u

[neon epoch]

cause it’s the one page he wrote ^^

[radiant summit]

point still stands

[neon epoch]

tabs cringe 4 spaces supremacy

also, i copied the code cas found problems in from kenny sooooooooooooo

[jagged pecan]

https://docs.papermc.io/paper/migration#from-craftbukkit-or-spigot
mentions paper.yml as where new config options get put

[radiant summit]

will fix in a sec

[neon epoch]

hyperlink it to the config page

pls and fanks

[radiant summit]

yeah

once I get yarn onto my pc

XD

[neon epoch]

just do it on web ide!!???

[spice temple]

Dot key is the most important on gh

[neon epoch]

exactly! github.dev goes hard

[radiant summit]

so weird

also tell me to use spaces /s

[radiant summit]

paper-global.yml or config/paper-global.yml to make it clearer

same for world-defaults

[neon epoch]

probably config/

not sure 🤔- what does it look like

[radiant summit]

shit

tbh I'd force a new line

[neon epoch]

those pages do say their file paths on them so maybe remove that

[radiant summit]

paper-global will still be split

[neon epoch]

don’t split it

[radiant summit]

wdym don't split it

[neon epoch]

erm

not sure

[radiant summit]

I can't make the browser not split it if it doesn't fit lol

,

[neon epoch]

maybe try and make the rest of the sentence shorter / longer to prevent it

that works

[lilac edge]

there's a css style for that

[radiant summit]

yeah definitely not modifying css

simplest solutions are the best solutions

and that could potentially break it in other places

[lilac edge]

>:(

[fair river]

Just wanna comment that I am so happy so many people are helping with the doc site very much appreciated!

[neon epoch]

TRUE. thanks everyone that reviews PR's and that make them!!!

[radiant summit]

@serene vault you gonna do stuff on https://github.com/PaperMC/docs/pull/222 or do we just fix ourselves

no hate in that message to be clear lol

[jagged pecan]

only some thanks to people that review my prs, i don't like criticism /s

[neon epoch]

https://paste.ollieee.xyz/ilinuvefej.rb

[jagged pecan]

s/developed/improved ?

[radiant summit]

I mean Bungee is actively developed I guess? And I still wouldn't say Velocity has improved mod support when it just won't work without extra plugins or won't at all

so sth like partial

[neon epoch]

yah i just added some stuff

[radiant summit]

to that PR or what

plz push it somewhere lol

[neon epoch]

i dont want to just hijack the PR lol, just messing around

[serene vault]

A lot of what was mentioned in the comments doesn't really fit the intend of the PR imo

its intended to be easily understandable. something like adventure doesn't belong there, the average server owner does not know or care what adventure is

[sharp pivot]

adventure seems like it would fall under "api supporting modern minecraft features"

[radiant summit]

api supporting modern minecraft features is generally a lot vague

[serene vault]

So whats missing is pretty much a difference between Waterfall and Bungee, maybe an introduction and a note about modern forge

I like Ollies approach of multiple ✅ for efficiency, then at least it doesn't look like Waterfall and Bungee are the same

Maybe?

Resource efficient and higher player counts seemed like kinda the same thing to me

[radiant summit]

lgtm

[serene vault]

Not sure about Snap, mentioning unofficial plugins in the docs is kinda meh

[neon epoch]

not really but i think it looks alright. im not sure about including it for the sake of having something else different between bungee and velo. and snap - we do that a bit. just disclaimer it

[south thunder]

How about "✅ +" in Velocity resource efficiency to avoid the double emoji

[serene vault]

its kinda tiny

[still apex]

looks weird

[radiant summit]

imo double is good

[serene vault]

Not sure about ❌* vs ❌/✅* for Bungee plugins. Both seems correct, but it makes the table look even more one-sided

[radiant summit]

any symbol we can use as "partial"

[serene vault]

there is a green cross ❎ but idk

[south thunder]

🟨 Maybe?

[serene vault]

looks alright to me

[neon epoch]

👍

tabs

ew

[serene vault]

replaced them with spaces and fixed the disclaimer

[neon epoch]

cool beans, lemme take one last look

https://tenor.com/view/oprah-winfrey-you-get-an-approval-getting-approval-gif-16487823

[radiant summit]

I'd wait if Mini has sth to say about it since he also reviewed

[sharp pivot]

approvals for everyone

(or well, only malf)

[neon epoch]

nope

i kinda saw this message after i merged it but it looks fine really.

besides, his comment was addressed

[willow citrus]

is the docs website working currently? I can't seem to access it
nvm, it works with VPN

[neon epoch]

works fine for me.

[ancient quiver]

you should be able to access it without a vpn ofc

if you consistently can't access it without a vpn let us know here and we'll dig a bit deeper into what might be causing that :)

[willow citrus]

yeah its consistently not working without a VPN, what sort of info should I give?

nevermind, it magically worked again without a VPN, sorry for the ping
update again: it stopped working

Not really sure what is happening but its random

[spice temple]

Blame your ISP?

Is it a DNS failure or what error do you get?

[ancient quiver]

^ what do you see when you try to access ut

also, what country and isp? (feel free to dm if you don’t want to share publicly)

[spice temple]

Or modmail

[willow citrus]

too long to respond/cant reach

[willow citrus]

sent it in modmail

[spice temple]

Mmh

Try running a traceroute I guess

Def not something we can do much about

[willow citrus]

it seems to be working just fine now I guess ISP was having a fit

[echo geyser]

I am actually interested in this lol

[still apex]

generally you shouldn’t randomly tag people

[echo geyser]

Would have been better to use modmail I think

[spice temple]

Please don't ping random people

We aren't interested in feeding some AI shit

Please respect our license

If you use it for some AI shit, we require explicit attribution

[spice temple]

Aannnmd they instantly left any deleted their message, kekw

And nothing of value was lost

[near ice]

Do y’all have a deleted message logger?

[spice temple]

Ye

Not worth reposting, some idiot wanted to sell us a chat bot trained on our own data basically

[near ice]

Lmaoo that’s funny

Yeah I was just curious

I should just start writing love letters to staff via deleted messages haha

[spice temple]

We don't really look at the log unless we need to

It would be too much

[near ice]

Yeah understandable

It’s more of a “there so we can look stuff up when we have to”

[spice temple]

Ye

[supple comet]

what is it

its deleted😔

[spice temple]

^

[spice temple]

/ban @knotty creek scam

[still apex]

<@&748618676189528155>

[spice temple]

mfw

[mental sleet]

(65009e75cdf07f25f6aca080) // @knotty creek (@derechteadmin / 976779367868952596) has been banned by @spice temple (134340832093405184)

[radiant summit]

:(

[still apex]

should Java here be capatalized?

[radiant summit]

Either capitalized or in inline code like- java package

[still apex]

@neon epoch !

[neon epoch]

yeah we capitalise java

[still apex]

no

well yes

something else

https://github.com/PaperMC/docs/blame/main/docs/velocity/dev/how-to/plugin-messaging.md#L8

[neon epoch]

java isn’t on that line

[still apex]

it's not related to java

[neon epoch]

i am confusion

[still apex]

https://i.imgur.com/0Eq4vV2.png
https://i.imgur.com/PWje9wC.png

[neon epoch]

oh lol, pr it

thanks for the review on my pr cas, i’ll probably be a bit slow for actual code at the moment though as i’m getting ready to move to uni

thanks @still apex 🥰

[neon epoch]

Wow really dismissing my request changes that was there to block the merge until paper pr done lol

[neon atlas]

I am about to merge the paper pr

soooo

Thank you for the blocker

[neon epoch]

🙄😂

ew weird middle emoji

[young matrix]

This has been resolved.

[jovial shell]

https://docs.papermc.io/paper/dev/getting-started/paper-plugins

What controls this embed generation?

I think it's because the source text is broken into two lines in the markdown?

So it's no longer the first sentence

which in that case makes it literally a backspace to fix

but im unsure

[lilac edge]

https://github.com/PaperMC/docs/blob/main/docs/paper/dev/getting-started/paper-plugins.md?plain=1#L7-L8

[jovial shell]

I know that much, my question is the embed pissy because the intro is two lines instead of one?

[lilac edge]

yes - it's technically working as intended since markdown generators treat lines close together like that as one paragraph

& since the source code is blah blah blah\nblah blah it gets parsed literally in the embed

[young matrix]

the descriptions are quite poor. this is what creates them https://github.com/facebook/docusaurus/blob/main/packages/docusaurus-utils/src/markdownUtils.ts#L123-L201

the biggest issue is that where it is done the markdown isn't actually compiled yet. so it just uses regex

although really that's just filler and a manual description should be written for each page. but that is a lot of work

[subtle moth]

is there a plugin to let bedrock players build/see stuff on the nether roof

[neon epoch]

fyi i started working on this ^^^ written descriptions for a lot of them but then i went out so docs got delayed 😭😭😭😭

[coral trench]

you can config geyser

in config.yml

[supple comet]

You here

[coral trench]

i am everywhere lol

[neon epoch]

no way you actually read them all that quick lol

[radiant summit]

I did

I read fast and was mostly looking for casing and punctuation

I started as soon as you PRd 😜

[still apex]

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

[neon atlas]

if you have a nice replacement for the "Explination to the spigot.yml" one

its the only one out of line

[still apex]

bukkit also

[neon atlas]

ye

[neon epoch]

sound gut 👍

[neon atlas]

beyond that, LGTM 👍 noice work

[neon epoch]

done @still apex

[still apex]

where is the description actually used?

embeds?

[neon epoch]

yeah

see previous comments

addressed that last one thanks

[neon epoch]

can i get a review on the nms one please from a team member 🥰🙏

[radiant summit]

no

[still apex]

no

[neon epoch]

i don’t need one from you cas, you already have 🥰

[south thunder]

<@&748618676189528155>

[mental sleet]

(650df99ecdf07f25f6aca09a) // @proper sequoia (@minhdayneban / 1020553811158384640) has been banned by @ancient quiver (1098722699116810331)
Reason: steam scam spam

[ancient quiver]

smh nacio ninja'd

[radiant summit]

[neon epoch]

all reviews addressed on 241

pls and fanks @radiant summit re -review 🙏

[neon epoch]

also, when 1.20.2 is released i can test 212 - if it works cleanly its likely ready for merge 🥰

[radiant summit]

I'll think about it

[neon epoch]

https://tenor.com/view/guy-arguing-guy-talking-to-wall-talking-brick-wall-gif-18667615

[still apex]

who are you

[neon epoch]

me

[neon atlas]

@radiant summit are you gonna write up a quick closing message to the holder issue ?

[eager plover]

"peace ☮️ "

clicks close

[radiant summit]

I was just gonna write fixed

but if you want to

[neon atlas]

sounds good xD

Could have PRed the change instead to autoclose it

[radiant summit]

or just put it into the commit

yeah, did that before

why is every issue help wanted

[eager plover]

it's a common gh label that the site exposes

[radiant summit]

on the docs to be clear

[eager plover]

like, people who can't code could get hacktoberfest rewards for writing documentation

it's just a way to attract people externally or whatever

[radiant summit]

oh that's soon isn't it

[eager plover]

but, yea, gh lets you search for that lable across the entire site, and so i'd imagine it's just being used to attract attention to it, cos who wants to write docs, amirite

[near ice]

The most real thing ever said

[neon epoch]

i’ve been pinged via email

[radiant summit]

who would do that

I wonder

[neon epoch]

oh my god the docs channel has activity!!!

[radiant summit]

and it's not nsfw spam this time

shocking right

[neon epoch]

yeah that ain’t addressed yet got a pr that can close that tho if i worked on it

is partially tho

236 - gotta actually finalise the design

[radiant summit]

or just get rid of those files on hardfork

cc @neon atlas

can we? 🥺

||remove commands.yml, help.yml, permissions.yml so we don't have to write docs for it||

[neon epoch]

i’m gonna say no, anyways the problem is with css

[neon atlas]

another 5head move

[neon epoch]

z index is not a simple fix before someone says that

[radiant summit]

just use text smh

[neon epoch]

because of the way i still need to detect mouse for some area around the box

wut?

[radiant summit]

you're the wizard Harry

[neon epoch]

-5 brain comment my lord

[spice temple]

Why does the icon have a z-index?

[radiant summit]

I mean whatever the i inside a circle is

[neon epoch]

because there is an area around the box that allows for the box to stay open if the cursor is still within it, however if they are in this area and hover over a different i that one should open. top down it should look like:

current popup
all i tags
the area of effect for detecting mouse leaving

however getting the z index for that right wasn’t working

[radiant summit]

can't it just toggle on-click

[neon epoch]

it gets grim and overlappy when you have multiple

[radiant summit]

or is that so lame and 2010

[spice temple]

Just add a separate element for that then

[neon epoch]

for what?

[spice temple]

For the area that should still count

[neon epoch]

it has one

[spice temple]

But why does that give the icon a z-index

[neon epoch]

because the icons need to overlap the “area of effect”

cause otherwise your cursor is floating in free space and you can’t activate the other i’s

[spice temple]

I'll have to play around with that myself, lol

Z-index on the box won't help because it's a separate stacking context I assume

Maybe a random isolation: isolate would help

[neon epoch]

errr yeah it’s an absolute

maybe i’m not a css’er

[spice temple]

Neither am I

I just know that stacking contexts are annoying

[neon epoch]

hehe yeah it’s been a while

[neon epoch]

^

[jagged pecan]

actually disregard my pr review, i didnt see that you wanted them to still be interactable, even though they are hidden (although im not sure that thats great for ui, esp if you "scan" along the text with a mouse)

[neon epoch]

beautiful i am way to drunk to review that change but ill maybe take a look tomorrow 🥰🥰

[neon epoch]

okily dokily - automation works !!!

[last bear]

Nice

[neon epoch]

This look alright for your comment mini?

[odd harbor]

explain-mojang-mapped-servers.patch by @neon epoch: https://pastes.dev/L77yv4mMVu

[neon epoch]

ew, hang on

diff --git a/docs/paper/dev/misc/internal-code.mdx b/docs/paper/dev/misc/internal-code.mdx
index 8841550..238978c 100644
--- a/docs/paper/dev/misc/internal-code.mdx
+++ b/docs/paper/dev/misc/internal-code.mdx
@@ -63,6 +63,16 @@ Paper is re-obfuscated at runtime. You can use a plugin like [Reflection Remappe
 reflection references. This will allow you to use the de-obfuscated, Mojang-mapped, names in your code. This is recommended as
 it makes the code easier to understand.
 
+### Mojang-Mapped Servers
+
+Running a Mojang-Mapped (moj-map) server is an excellent way to streamline your processes because you can develop using
+the same mappings that will be present at runtime. This eliminates the need for remapping in your compilation. If you
+are creating custom plugins for your server, we highly recommend running a moj-map server. It simplifies debugging and
+allows for you to hotswap plugins.
+
+In the future, the Paper server will no longer undergo remapping. By adopting Mojang mappings now, you can ensure that
+your plugin won't require internal remapping when we make the switch.
+
 ### Getting the current Minecraft version
 
 You can get the current Minecraft version to allow you to use the correct code for a specific version. This can be done

[spice temple]

I wanted to say that debugging is easier cause stack traces but we already deobf those, right?

Sounds nice, can't check for English stuff tho

[neon epoch]

Yeah stacktraces are automagically remapped before logging

[eager plover]

find . \( -type d -name .git -prune \) -o -type f -print0 | xargs -0 sed -i 's/minecraft\.fandom\.com/minecraft\.wiki/g'

[neon epoch]

🤓

thanks cat

[radiant summit]

so helpful truly

yk I can click on buttons and find and replace

[eager plover]

I'm lazy

if I can automate shit, I will

I AM that one xkcd

https://xkcd.com/1319/

xkcd: Automation

'Automating' comes from the roots 'auto-' meaning 'self-', and 'mating', meaning 'screwing'.

[still apex]

what this do

[radiant summit]

removes fandom

[eager plover]

finds all files in a tree and shoves them through sed; said sed freeing us from the plague that is fandom

[still apex]

#1129091220858212452 message wha

[neon epoch]

yeah thats normal

"normal"

[twilit pivot]

😭

[lyric vale]

i have

problem

with velocity

very big problem

who can

help me?

liike

io.netty.channel.ConnectTimeoutException: connection timed out: /23.137.104.86:27003
at io.netty.channel.epoll.AbstractEpollChannel$AbstractEpollUnsafe$2.run(AbstractEpollChannel.java:613) ~[server.jar:3.2.0-SNAPSHOT (git-19abb909-b265)]
at io.netty.util.concurrent.PromiseTask.runTask(PromiseTask.java:98) ~[server.jar:3.2.0-SNAPSHOT (git-19abb909-b265)]
at io.netty.util.concurrent.ScheduledFutureTask.run(ScheduledFutureTask.java:153) ~[server.jar:3.2.0-SNAPSHOT (git-19abb909-b265)]
at io.netty.util.concurrent.AbstractEventExecutor.runTask(AbstractEventExecutor.java:174) ~[server.jar:3.2.0-SNAPSHOT (git-19abb909-b265)]
at io.netty.util.concurrent.AbstractEventExecutor.safeExecute(AbstractEventExecutor.java:167) ~[server.jar:3.2.0-SNAPSHOT (git-19abb909-b265)]
at io.netty.util.concurrent.SingleThreadEventExecutor.runAllTasks(SingleThreadEventExecutor.java:470) ~[server.jar:3.2.0-SNAPSHOT (git-19abb909-b265)]
at io.netty.channel.epoll.EpollEventLoop.run(EpollEventLoop.java:406) ~[server.jar:3.2.0-SNAPSHOT (git-19abb909-b265)]
at io.netty.util.concurrent.SingleThreadEventExecutor$4.run(SingleThreadEventExecutor.java:997) ~[server.jar:3.2.0-SNAPSHOT (git-19abb909-b265)]
at io.netty.util.internal.ThreadExecutorMap$2.run(ThreadExecutorMap.java:74) ~[server.jar:3.2.0-SNAPSHOT (git-19abb909-b265)]
at io.netty.util.concurrent.FastThreadLocalRunnable.run(FastThreadLocalRunnable.java:30) ~[server.jar:3.2.0-SNAPSHOT (git-19abb909-b265)]
at java.lang.Thread.run(Thread.java:829) [?:?]

this

is

problem

config

[odd harbor]

SPOILER_config.yml by @lyric vale: https://pastes.dev/D8fBq2ljOe

[lyric vale]

?

[fair river]

@lyric vale Please use the proper channel to ask for help #velocity-help and stop spamming

[lyric vale]

server ip is ok, everything it is fine

sorry

[fair river]

This channel is for the website itself

[neon epoch]

hehe

[jagged pecan]

Actually, do paper world config featureseeds override the spigot structure seeds?

[eager plover]

two different things

structure seeds and feature seeds that is

[jagged pecan]

Oh ok

In that case I might look over the paper configs for better defaults / option documentation (I don't think saying set it to randomises to see all the options is great, and showing what it does control should reduce confusion)

[eager plover]

We do hat because it needs to be done programatically because sod tryna add stuff for that

[jagged pecan]

oh cause configured features is a registry thing?

right

[jagged pecan]

huh the docs for sending plugin messages with velocity are wrong
https://docs.papermc.io/velocity/dev/plugin-messaging#sending-plugin-messages
it uses Player#sendPluginMessage to send a "bungeecord:main" namespaced packet?

oh is it meant to be representing what you would do in paper? but with velocities api?

[still apex]

looks like it

@neon epoch !!

[radiant summit]

I mean the channel name has to be a namespaced key

the fact you can still use .equals("BungeeCord") is backwards compat

[jagged pecan]

what?

i meant the direction thing

[still apex]

also that sends it to ththe client

should be the server

[radiant summit]

so what's wrong

[radiant summit]

besides that

[still apex]

well you shouldn’t send bungee messages on the proxy lol

when you can use api

and that probably wouldn’t do anything

[radiant summit]

why is this so cursed

[still apex]

a example from both bukkit and velocity should probably be added

[radiant summit]

Velocity sends a Bungee channel Connect to the Player??

[still apex]

for velocity docs by sending/receiving custom plugin messages

[still apex]

no

well that ezample does

[radiant summit]

is what I mean

[still apex]

i think we should fire ollie

[radiant summit]

imho this shouldn't mention bungee at all

[still apex]

yea

[radiant summit]

but explain how to send plugin messages

[still apex]

.

and that using that method on Player will send it to the player and not server

[radiant summit]

no because no one will take care of docs then

[still apex]

fair enough

[neon epoch]

hello bozos

you interrupted my nap

i thought that got fixed before

[jagged pecan]

btw im starting to re-write that page

i probably should have said before

[neon epoch]

i’m sick at the moment so i won’t be writing it ;)

[neon atlas]

Ger well soon!

[jagged pecan]

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

its partly written as a new docs page, so the diff (which doesnt appear on the github ui by default since i moved the file) isnt massively helpful

[still apex]

illl try to review later

depends on my head

[neon epoch]

mfw i remember i have a PR to review

https://tenor.com/view/father-ted-jack-frolicking-gif-7227415

[eager plover]

Did we end up getting a table for the forwarding mode setup?

i.e. modern = bungee off, velocity on
legacy = inverse

[radiant summit]

go rest

[radiant summit]

nope

https://docs.papermc.io/velocity/player-information-forwarding should probably get some quick table overview

[neon epoch]

https://tenor.com/view/never-angry-no-im-angry-i-said-never-gif-18662823

nah icl i didn't get up yesterday lol

half of what i reviewed probably wasn't your diff i just didnt like it @jagged pecan

[jagged pecan]

most of it was :) only really the bungeecord bit wasnt

thoughts on changing "message" int eh short description to "packet" or the longer "plugin message"?
message can get confused with change, plugin message might be too long and repetitive, and packet might get confused with handling actual packets

communicate is probably the best word to describe its use, but it lacks the directionality desired

[neon epoch]

these?

[jagged pecan]

yeah

[neon epoch]

plugin message works.

[south thunder]

I'm planning to expand quite a bit on the troubleshooting guide with common issues from #paper-help, such as
Broadly, server not starting
Common stack traces (failed to bind to port, tried to load newer world, invalid yml, datapacks, corrupted level.dat, plugins intentionally shutting the server down...), debugging startup scripts
Behavior issues
Entities not moving, entities moving differently, can't break blocks near spawn, keepalive kicks, slow chunk loading...
Common-ish crashes
Treasure maps, server has not responded in [x] seconds
Slightly more in depth performance diagnostics
Briefly talking about RAM usage. Maybe referencing Luck's guide? Not really planning to reference plugins or optimization guides here, just the measurement part
(Edits made above with new additions for my own reference)

Just to double check as this will take quite a bit of time, is this an okay addition even if not directly related to Paper? Also, if yes suggestions for new things to cover would be appreciated

[radiant summit]

Sure

[neon epoch]

sounds good

[white stratus]

not sure where I need to ask for this, but every now and then I find myself on the paper download page and try to find a way to get to the docs.
Without typing docs into the search bar it would be.. software -> paper -> documentation.
Is it possible to have something like an Icon/Label at the top that redirects to the docs page?

[neon epoch]

maybe in the top bar now it’s a bit more fleshed out nowadays?

[white stratus]

top bar has links to forums. hangar. so I think that would fit there. It could probably also go into the footer?

[eager plover]

navigation on the site is kinda meh at times

[near ice]

Or even change that header to say “Paper 1.20.1” instead of “Get Paper 1.20.2”
Then have the download button say “Get Paper 1.20.2”
And put another primary button next to or below it which says “Paper Docs”

Tho with the thing saying “downloads” that doesn’t necessarily make sense since you aren’t downloading the docs. I doubt anyone would even care

[sharp pivot]

if anyone wants an easy pr, the default value for https://docs.papermc.io/paper/reference/world-configuration#entities_spawning_monster_spawn_max_light_level recently changed to default

description should also mention that it defaults to 15 in the nether and to 0 in all other dimensions

[brazen moon]

The entities.tracking-range-y section in the world config is not documented

[echo canyon]

ill write up both of those rn

[neon epoch]

is that a new key lulu?

[sharp pivot]

it's semi new

[brazen moon]

kinda from this summer

[neon epoch]

hmm ok

just wondered if it slipped thru or i missed it :)

Maybe include something in the Paper Contributing.md about new config nodes requiring docs PR's or whatever

[echo canyon]

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

maybe can just remove the mention of what "default" does in the light level one? default is pretty self-explanatory

[neon epoch]

nah lgtm

[last bear]

1-2 simple examples of getting builds of a version or something would be good on https://docs.papermc.io/misc/downloads-api, the autogenerated docs aren't really nice to go through

[still apex]

A postman collection could maybe also be useful? or just with small examples

[spice temple]

do people still use postman?

IJ http client master race

[dawn bough]

yeah

I agree with you

[eager plover]

there was a postman alternative, but it kinda got replaced by something else, that something else got acquired and it looks like people are moving on to something else?

[neon epoch]

i mean swagger is ok but yeah ok - real question is what language though… Maybe a Java and Python example

[small harbor]

don't need to provide java/python examples tbh

just provide a curl command / postman docs and something can convert it into whatever language

maybe a bit of pseudo code but the api is not that complicated either

[last bear]

Yeah

Mainly just the obvious main use case provides with an example url

[neon epoch]

yeah i can probably look into that in a bit

[spice temple]

We provide swagger docs which can convert in any language, lol

[green kernel]

I use rapid api formerly known as Paw. (Mac only)

[neon epoch]

fyi i ran out of time - anyone else is welcome to it otherwise i’ll try remember tomorrow

or later tonight - just let me know if you are

[jagged pecan]

I prefer insomnia imo

[spice temple]

nothing beats the IJ web client

its basically cli but good

[lean venture]

The other day didn't see much of it but today took some time and damn it looks quite pog

https://docs.andre601.ch/asl-api/index.html andre's using my javadocs in his project and actually looks nice

hell this is the wrong channel

lmao

my bad

[spice temple]

Speaking about IJs http client

https://blog.jetbrains.com/idea/2023/10/intellij-idea-2023-3-eap-3/

It keeps getting better!

The oauth stuff is such a nice time safer

[jagged pecan]

I mean i haven't actually tried it, so I won't say it's bad or anything

I guess a way to do the data generated stuff for the docs is to make a plugin that just gets all the information?
That can be run each version as needed.

• built in commands
• built in permissions
• all default config options, from the default state (incl paper-plugin.yml)

Issues with this approach

• the maintainability: a lot of that information is internals, so would probably need to be changed more frequently
• having it not replace the java docs, like leaving off generating block / item / entity info
• deciding a format to have it in, before it gets rendered front end (probably yaml)

[fallen condor]

is that only in ultimate

[spice temple]

🤷‍♂️

[neon epoch]

Automating it, i kinda imagined it would it be an artifact published to the repo @ CI stage however this does have problems, not necessarily space wise as the jars are already pretty hefty, but with regards to formatting (some stuff like the generic key'd ones for entities) and also just general like proper formatting. Plus, without actually importing patched paper files this would be a regex mess

[jagged pecan]

I mean most of that stuff just needs to run once per version, but a ci would be nice

I meant extracting that info from a running server (ie: everything is loaded)

[spice temple]

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

Thought on having a full Gradle file here?

For people that don't know Gradle and don't apply the java plugin

[vocal halo]

i think there should be a MinecraftDev plugin tutorial too. You can mess up more with trying to set it up by hand than with the MinecraftDev plugin

[still apex]

a basic template plugin could also be useful maybee?

[vocal halo]

well, the intelliJ plugin creates a basic template plugin or fo you want to add more?

[spice temple]

Ye, maintaining a basic plugin seems meh

[vocal halo]

yea

[coral brook]

How could that possibly happen

Most ides will generate a gradle project with the java plugin by default

Gradle itself does so on the init task if you select the java plugin

[spice temple]

Idk, not the first time I have seen it

[coral brook]

I guess it wouldn't hurt

It doesn't make sense to me as how they end up writing their build.gradle from scratch instead of relying on gradle init but well, I don't expect a beginner's approach to be all that efficient either

[still apex]

eternity has an important question for everyone

[fair river]

[empty grove]

now is the time

[fair river]

What do you guys think of this idea? adding Doc that links to https://docs.papermc.io/ on overall header

[spice temple]

Sure

If you fix the alignment

[still apex]

that was paint

[spice temple]

Excuses.

Even paint allows you to count pixels

[jagged pecan]

It is paint

[still apex]

did it fail the linter or is it just red bc of vercel?

[fair river]

@still apex has been volunteered to submit this PR.

[jagged pecan]

What linter?

Doesn't look like there is any GitHub actions to run one

[still apex]

prettier

[eager plover]

being frank, I'm somewhat not 100% happy with the site atm

doc links is one of the thing i felt was missing

but, generally, i feel theres too many clicks

[still apex]

team and contribute could probably be moved else where

[fair river]

Idea comes from me going to the site wanting to read doc so I think it being on top makes sense.

[still apex]

Should "Docs" be removed here? https://i.imgur.com/dNcQg1g.png

Since it's already on the docs site

this is on the docs site btw

[radiant summit]

will remove

[still apex]

my pr

[radiant summit]

not if I commit first

[sharp pivot]

--force

[radiant summit]

@still apex stop me

[still apex]

also "Javadoc" or "Javadocs"?

[eager plover]

Generally see it as javadocs

which, I mean

I feel is wrong

[still apex]

main site says Javadocs

[radiant summit]

I mean

javadocs looks weird

whytf would we write it like that anywhere