Enjoy the vacation away from powergas !! 
#docs-website
fair river
still apex
@neon epoch don't get sunburned
eager plover
I do not recall approving such a vacation ||but, have fun, I guess||
neon epoch
I do not recall approving such a vacation ||but, have fun, I guess||
Should have vetoed it before it got to HR
still apex
i wasn’t invited to the meeting
raw breach
real question is why weren't you invited to the vacation? 
opal flare
sure
still apex
There should be a easy way added to diff the config's from the docs to a up to date config.
drowsy zinc
I could do that
neon atlas
yes
vague hornet
cool!
neon epoch
Yes.
still apex
from everywhere or just contact
neon atlas
https://github.com/PaperMC/docs/pull/423 cc @echo canyon @last bear (not ollie, enjoy barca) @burnt ice
still apex
1.21?
neon atlas
yea
still apex
build failed
neon atlas
someone needs to do the version thing
neon atlas
lynx cant code
it build locally 😭
still apex
last bear
k what now
neon atlas
Yea probably
still apex
still apex
@opal flare ^^ I don't think the cloudflare-pages bot is supposed to run
echo canyon
should we talk about what happens if you load the world without registering the enchantment?
neon atlas
Yea, I guess a third note won't hurt 
opal flare
no I think I may have run it?
what did you do to run it?
neon atlas
I clicked rerun on something in github because the build thing did not seem to update
spice temple
yey I can contribute at least something to the update, lol
neon atlas
last bear
You can shine next one when we hardfork 
spice temple
ok but do you really want me to port patches? 😄
viscid thistle
Hard fork 1.21.1 confirmed
lean venture
if that happens I shall kiss you
echo canyon
porting patches happens after running the history stuff tho right?
last bear
Yeah
echo canyon
then we change decompiler/param mappings and watch it conflict trying to apply the per-file patches on files we don't modify
neon atlas
should we talk about what happens if you load the world without registering the ...
Added
Exceptions thrown by plugins during this phase will cause the server to shutdown before loading
as missing values or modifications to the registries would otherwise cause data loss.
last bear
Meaning we can do it all in parallel
echo canyon
yeah. a benefit for sure of per-file, is work can be done by multiple people at once
kinda, probably still some conflicts, but way less than sequential patches
neon atlas
We should just roll a dice to see who gets what file
Owen rolls ServerLevel
paper in shambles
viscid thistle
rolls any patch*
viscid thistle
Dammit Mini you had 1 command to run
spice temple
I did
still apex
pnpm docusaurus docs:version:paper "1.20"
spice temple
Ij didnt show the new files 💤
vocal halo
eeeeb3a
spice temple
jokes on you, I ran git push via cli 😄
because something is borked with the github auth
in IJ for me
still apex
my review looks a bit broken
neon atlas
commits in IJ, pushes via cli. Gamer move
still apex
ctrl + g is putting the suggested thing twice
opal flare
jokes on you, I ran git push via cli 😄
but you used git in intellij to commit
that was the mistake
eager plover
I just use everything in CLI because I don't trust git GUIs unless I just want a pretty picture
spice temple
I am still cooking
neon atlas
🧑🍳
last bear
🐌
spice temple
last chance before I merge?
neon atlas
Alright, merge for registry then?
last bear
after you addressed those reviews ig 
drowsy zinc
I painstakingly wrote all that on my phone
last bear
Noice
neon atlas
FARMING commits
last bear
it's not farming if you're sane ||(not riley)|| and don't use merge commits 
viscid thistle
Idk if a direct upload from the action counts as a build but we get 500 per month
still apex
500 builds on github or cloudflare
viscid thistle
Should be no limit on github since os
but idk if a direct upload from the pages action counts as a build or not.
neon atlas
Done ™️
drowsy zinc
I just added the suggestion
neon atlas
Hm?
drowsy zinc
I replied with the suggested change so you could incorporate that but you did it manually
last bear
You can merge whenever
last bear
We go zoom today
neon atlas
did't even get a second approval wow
you had your chance
still apex
i just got out of my shower
drowsy zinc
could probably use actions' concurrency group feature to cancel old tasks if a newer one is running
still apex
Can we overrule Ollie and get this merged https://github.com/PaperMC/docs/pull/410 no one uses light mode anyway
also https://github.com/PaperMC/docs/issues/412 can be closed
neon atlas
thank you
drowsy zinc
Can we overrule Ollie and get this merged <https://github.com/PaperMC/docs/pull/...
(I merged main so there's going to be a build from pages if anyone wants to look at the preview)
lean venture
weird interaction but ok
still apex
lean venture
ooof
spice temple
Who broke that? Smh
lilac edge
i'm sure the culprit is the one listed in the footer of that image 👀
drowsy zinc
I touched the page not the component
drowsy zinc
true
still apex
I could do that
!
lilac edge
haven't been able to reproduce this in ios safari or on desktop in mobile mode
lilac edge
meant to add that i can't reproduce in discord browser either
outer elkBOT
still apex
when going discord -> safari i can reproduce, still shows it weird on discord
lilac edge
oh i can reliably reproduce by changing the font size through safari
stackoverflow says to apply the following css style
body {
-webkit-text-size-adjust: 100%;
}
is your font size set to 85% by default?
lilac edge
good ol' safari https://stackoverflow.com/questions/48230608/flexbox-div-not-containing-all-elements-in-safari-but-works-fine-in-chrome
in any case it'd probably be good to switch it to a column when viewed on mobile
it ends up getting around that weird problem on safari (plus less clutter on mobile)
still apex
lynx very helpful
neon atlas
always
still apex
echo canyon
is https://github.com/PaperMC/paper-trail mentioned in the docs anywhere as a way to notify users if someone tries to run a paper plugin on a spigot server?
echo canyon
yeah, me neither until jmp posted a link
still apex
woo
still apex
Do we have any basic spark docs? Or even a factoid that links to spark docs
outer elkBOT
still apex
oh it’s timings lol
i was looking for spark
also please fix that faction
factoid
there’s a space in front of For more information
fair river
It’s there to piss you off
still apex
fix it
fair river
I can’t. The fancy embedded one Riley has to fix
neon epoch
Just got an email from algolia - the move to Cloudflare seems to have broken the scraper
still apex
broken how
neon epoch
[docs-papermc] Blocking error:
The difference between the number of records:
from : 7.1k
to : 0
is too large (100 %), this limit can be modified in the Editor (currently 10 %)
still apex
that doesn’t say what’s broken!!
neon epoch
No it doesn’t
Crazy that
It means that something has fucked the scraper
Just needs someone to go thru the config and find the issue
still apex
did vercel generate that before?
still apex
if no one does it i can create a pr in like 2 hours
eager plover
we already appear to have that plugin installed
still apex
@neon epoch what did you break
drowsy zinc
env variables are inserted on build time and the cloudflare pages deployment step runs after building, so there's no way to get the URL there
drowsy zinc
idk you can't get the url before it's deployed
I made a patch that tries to guess the deployment ID, I could PR that if no one has a better idea
odd harborBOT
I made a patch that tries to guess the deployment ID, I could PR that if no one ...
fix__correct_base_URL_for_Pages_deployments.patch by @drowsy zinc: https://pastes.dev/tbQx1bhriH
eager plover
I'd generally prefer to leave it to the docs folk but that looks fine to me
neon epoch
fix__correct_base_URL_for_Pages_deployments.patch by <@504916819987922954>: http...
Why no patch syntax highlighting
Silly bot
still apex
pastes doesn't have one
opal flare
PR?
still apex
okay
opal flare
why is the cfpages app commenting still
still apex
only seems to happen on branches on the repo not from external al
supple comet
IMO it would be better to separate the normal plugin stuff and paper-plugin stuff in the development section https://docs.papermc.io/paper/dev/api
neon atlas
Would actually not be too much against this either. We have seen enough confusion
still apex
hey lynx
drowsy zinc
IMO it would be better to separate the normal plugin stuff and paper-plugin stuf...
wdym paper-plugin stuff? if you mean paper-plugin the file, I can't see anything related to it in the section you linked
eager plover
but, not all of that is tied to paper plugins
drowsy zinc
ya
though if you move the paper-plugin specific parts (of the command api for example) elsewhere, I myself wouldn't expect them to be shoved in a paper plugin quarantine file, rather in the actual topic's page
the registry api page already has a big warning box for registry mutation, I'd say that's sufficient - now to do that in the other places
lean venture
but, not all of that is tied to paper plugins
You could make a "paper specific category"
eager plover
the problem is that you fragment documentation there
still apex
what about just a generic "This is a Paper Plugin only thing" banner
not banner
thing thingy https://i.imgur.com/107cwSm.png
eager plover
the registries are going to become more important over time, and seperating manipulation and utilisation will only just create doc flow issues
drowsy zinc
not banner
admonition
eager plover
probably be much easier to just have a little tag that we can put in sections that are more "advanced"
vocal halo
thing thingy https://i.imgur.com/107cwSm.png
But it doesn’t say that it is paper-plugin specific which it should
drowsy zinc
yes
still apex
yes to what
drowsy zinc
lifecycle api can be used without a loader/bootstrapper
eager plover
well, the "big fun" is the whole "what lifecycles are available to you without that", but, stuff like new command API works, you just won't be able to register early enough to be there for command functions to work if not
supple comet
wdym paper-plugin stuff? if you mean paper-plugin the file, I can't see anything...
I meant everything that required a "paper plugin" to operate
mb forgor to disable reply ping
supple comet
what about just a generic "This is a Paper Plugin only thing" banner
This also would be nice
still apex
Maybe an idea to have a small section, or even a discord factoid regarding .paper-remapped folder?
nvm lol
maybe added here https://docs.papermc.io/paper/reference/configuration
outer elkBOT
Starting in version 1.20.6+, Paper uses Mojang mappings at runtime. Any plugin that still uses Spigot names for internals will be automatically remapped to work on Paper (Read more). The folder is used to store the remapped plugins. You should leave it untouched! 
radiant summit
Do we actually have a doc page for this?
it's kinda a detail people don't have to learn about
fair river
ok so we will keep the original simple faq
still apex
Do we actually have a doc page for this?
https://i.imgur.com/eJ8CThY.png thoughts on something like this
fair river
That’s actually great.
The folder description should just briefly explain what it is for
outer elkBOT
Starting in version 1.20.6+, Paper uses Mojang mappings at runtime. Any plugin that still uses Spigot names for internals will be automatically remapped to work on Paper (Read more). The folder is used to store the remapped plugins. You should leave it untouched!
still apex
https://i.imgur.com/0XTtn8u.png I made it link to that forum post but doesn't look too great
fair river
used to store remapped plugins. (Learn more)
Maybe? Otherwise people don’t know there is a link there
still apex
Don't think I can make the (Learn more) clickable, the whole folder is clickable
fair river
Ohhh nvm
still apex
see dm
fair river
Yeah I think it’s fine
craggy cedar
Hey y'all. I'm currently working on the docs for the new brigadier command API and I want to add a reference to the CustomArgumentType.Converted interface using the <Javadoc> tag. but as it converts dots into slashes, there's no way that Im aware of to link this page...
That is, if you don't want to use a direct link text
echo canyon
does $ not work for the inner class?
if not, the javadoc component should probably be made to turn . into / and $ into .
so that inner classes are referenced like io.papermc.paper.command.brig.argument.CustomArgumentType$Converted
vague hare
Hello everyone, I recently registered on the forum and was immediately blocked. I didn't even write anything 
What could be the problem? (I have not found a special branch for this, so I am writing here, sorry)
scenic gull
This is the channel for our documentation. I'll alert someone who can look into this for you, though.
craggy cedar
so that inner classes are referenced like `io.papermc.paper.command.brig.argumen...
ahhhh that makes sense! thx!
scenic gull
Hello everyone, I recently registered on the forum and was immediately blocked. ...
Should be resolved.
craggy cedar
Pull request for updated brigadier docs is out 🙂
still apex
not very resolved https://i.imgur.com/qLJUrlr.png
craggy cedar
As he said, it is part of the prettier config. which you need to prettyprint and not have format errors. And you dont want my prettier config on github
(Im assuming)
drowsy zinc
it's the project's config
drowsy zinc
I skimmed over it and got some suggestions, but I'm in a sleeping bag atm
fair river
Go to bed or hoshino will be mad
craggy cedar
yeah, just dm me
drowsy zinc
I'll make a review on github tomorrow or post-mortem if it gets merged
craggy cedar
okay haha
When i try to commit changes, there are now formatting errors in files that i haven't touched... should I fix those and add them to the same commit?
craggy cedar
no
i just removed the .prettierrc file from gitignore
but maybe installing it locally on my machine somehow broke it
but then there is no .prettierrc file in the main docs repo
still apex
how are you building / formatting it?
craggy cedar
pnpm run format:check --write in the root of the project. I only did this after my last commit where the format checks failed...
craggy cedar
I fixed it by running the prettier formatter locally and removing the .prettierrc file from gitignore
Formatting should be fixed now. If anyone has any further suggestions: https://github.com/PaperMC/docs/pull/436
last bear
I’m ofc out of touch, but am I the only one that thinks search sucks
Can’t nicely find config options often, and randomly I’ll be sent to 1.19 docs or something when that same page or entry exists in the current version
fair river
I think we’ve gotta a lot of recent contributions and doc pages are gaining in a fast pace. Maybe we should get together and do a restructure to make it easier for enduser to navigate? Or find ways to improve search feature.
last bear
Navigation isn’t a big problem, just the search field search
eager plover
we should exclude the versioned pages if we can
there is no reason for them to be in the search
heck, if we can just make those branches or something that would be so much nicer
radiant summit
I’m ofc out of touch, but am I the only one that thinks search sucks
sitemap lists old versions
still apex
How are you supposed to exclude the stuff from the sitemap? Well ig you could just manually exclude it but don't think (regex maybe actually?) to exclude versioned
drowsy zinc
the problem isn't the sitemap, rather the algolia plugin's contextual search isn't working properly
the documentation points to an issue with the indexing, someone should probably check that the faceting fields are correct
particularly the version field
still apex
someone as in someone with algolia access?
neon epoch
Me and machine spent hours on this before. The crawler configuration really sucks to work on. Also, about not finding config options @last bear - is it a modern one? If so, it only gets refreshed every Friday morning.
still apex
is there a force update command
neon epoch
I’m now running it
still apex
there is not
neon epoch
Oh, I mean I am updating the crawler
still apex
for the bot I assume you were takling about
so, it only gets refreshed every Friday morning.
neon epoch
No, this is the crawler that updates the algolia indices
still apex
ah
drowsy zinc
would a PR with a local search be accepted? if I configured one from the docusaurus docs and it were better than algolia
neon epoch
Maybe, depends on the size of the search index
drowsy zinc
I'll give it a shot then
still apex
would a PR with a local search be accepted? if I configured one from the docusau...
so no algolia?
last bear
Me and machine spent hours on this before. The crawler configuration really suck...
Huh might have been
drowsy zinc
it could just read the raw sitemap no?
still apex
currently it uses the algolia api
with app id and secret
though it could probably also be moved to @mental sleet if it’s needs to be updated..?
neon epoch
currently it uses the algolia api
Currently it works like this:
Algolia crawler scrapes the site every Friday morning and propagates into the algolia API with all the records
Algolia API serves as a search interface
The bot & Website queries the API
drowsy zinc
well you could keep the algolia crawler running for the bot
still apex
it doesn’t crawl it from the website though, it gets it from algolia afaik
drowsy zinc
yes?
the algolia scraper doesn't rely on a component on the site afaik, so even if you were going to replace the site search with a local one, algolia would keep scraping if you didn't shut it down
radiant summit
the problem isn't the sitemap, rather the algolia plugin's contextual search isn...
yeah no
Google will definitely use the sitemap
and if outdated shit's there, it will surely put it in results
drowsy zinc
never seen it happen (if you're searching for latest)
still apex
the algolia scraper doesn't rely on a component on the site afaik, so even if yo...
ah lol
neon epoch
As in there are plugins that enable doing this locally
drowsy zinc
I did some debugging, the issue is that the docusaurus_tag:docs-paper-current tag in algolia includes versioned pages as well
if you switch to 1.20 for example, it behaves as it should and only shows results from 1.20 docs (+ other projects)
about the local search stuff, I didn't find any existing plugin that was able to do the multi-project multi-version setup easily
still apex
??
radiant summit
https://docs.papermc.io/paper/dev/plugin-messaging#plugin-message-types is missing KickPlayerRaw 😔
still apex
open an issue
neon epoch
"command" is a trending search term this week in our docs
drowsy zinc
types?
eager plover
int, string
still apex
@drowsy zinc I disliked your review
drowsy zinc
cope
drowsy zinc
fair river
drowsy zinc
still apex
@neon epoch I don't see any difference
neon epoch
what is the point of versioning adventure
opal flare
re:
Unfortunately, it currently is not possible to get a 100% Vanilla experience in Paper.
why? can we make a list?
fair river
I thought there was a PR in the work for that....? based on what earthcomputer's list?
CC: @still apex (when you wake up -.-_
fair river
so just document things that still isnt going to be Vanilla? I think that's a good idea
still apex
@vocal halo ^
opal flare
@still apex
still apex
no
vocal halo
re:
> Unfortunately, it currently is not possible to get a 100% Vanilla experien...
a list about what?
still apex
what is not vanilla i assume
vocal halo
I cannot do that alone
i know that some farms need adjusments in order to work on paper
trail jasper
maybe open a discussion about it on github
I have one or two things to add myself
like join messages are not sent to the player but others only in vanilla but not in bukkit
still apex
what?
spice temple
That smells like a bug, lol
trail jasper
If you join a vanilla server you dont see your own join message anymore but others do
in bukkit everyone sees it
including you
spice temple
Ah, the other way
Idk, that's not worth documenting imho
It's not gameplay
That's just a fix for consistency
trail jasper
sure but should be matched anyways
spice temple
I would argue no
frigid steeple
Is this a bug? In extreme cases there can be unexpected padding.
eager plover
I mean, I'd imagine that the goal was to centre the content
frigid steeple
then again, nvm
oh ok
eager plover
wrong equality check
so, it works because the thing will get the registered channel from the thing and return the same key object
so, if you keep it all in one class, it should work; but, looks a bit weird
outer elkBOT
eager plover
debating the long term implications of making Paperweight catch the unsupported java version and providing a bit of a friendly message to link people to there
we could also detected headed environments and pop up a message on the screen rather than just a "halp, I double clicked the jar and it does nothing?!" esque thing
hearty briar
debating the long term implications of making Paperweight catch the unsupported ...
doesn't paperweight set its own toolchain to be used anyway
the only scenario where that becomes an issue would be when they don't have the requested toolchain, which in that case you could use the toolchain auto-provisioning API but idk how to feel about a plugin downloading jdks to my gradle user home. Not an issue per se, just something that one wouldn't expect a gradle plugin to do I guess?
ah, you meant for paperweight to detect the compatibility between the Java version of the project and the Paper/Velocity API version. Thought you meant the version paperweight itself runs in
eager plover
either I commit to the repo in the next day or two, depending on my eye stopping from being an arse
or, somebody else deals with it
kthx ❤️
drowsy zinc
nacio 
radiant summit
😅
vocal halo
Interesting channel
radiant summit
hearty briar
feels like this should be a bug reported on Paper, not a docs one
tbf, vanilla has this bug too
which is in part an issue from Java itself: https://bugs.openjdk.org/browse/JDK-8016521
radiant summit
I mean, that issue says it's been fixed in 9?
I don't really have a way to check since I don't have anything only-v6-capable
hearty briar
I mean, that issue says it's been fixed in 9?
it says it has been partially fixed, but it isn't the whole story
radiant summit
heck, I don't even have IPv6
hearty briar
there's a proper fix coming but it is still a draft: https://bugs.openjdk.org/browse/JDK-8179037
well, it hasn't had much attention since 2019 but hopefully someone will care at some point lol
hearty briar
anyhow, Paper can "fix" it by setting preferIPv6Addresses to system which should work for almost all scenarios, some say that using NIO SocketChannel avoids this issue completely as it has been implemented properly there, but it'd be annoying since HttpUrlConnection doesn't allow you to provide it in its socket factory
wispy scaffold
feels like MC-5
Because of the band?
still apex
https://docs.papermc.io/paper/misc/paper-bug-fixes should probably mention which config file
drowsy zinc
You will find these configuration options in the global configuration and the world configuration.
fair river
I think the issue is that the current generation has very short term memory and I do see people having issues finding where to change the configs.
Like maybe something like this...? 30 second MSpaint job 
last bear
I’m ofc out of touch, but am I the only one that thinks search sucks
https://i.imgur.com/mG2hyHD.png first two are Velocity (which I can't tell), third brings me to the overview page instead of where I want to, and then fourth finally is the one I want to go to
still apex
you’re not the first to complain and yes i agreee
neon epoch
nice one scorp
still apex
no problem
drowsy zinc
only thing with the search now is that algolia returns versioned pages for the docs-<project>-current tags, someone should check the faceting configuration
still apex
@neon epoch check it
neon epoch
what is a faceting configuration
neon epoch
attributesForFaceting: [
"type",
"lang",
"language",
"version",
"docusaurus_tag",
],
this?
drowsy zinc
idk just make it not return versioned pages for the current tag 😅
neon epoch
yeah i have literally no clue how to do that, ive spent many hours on this
neon epoch
im busy watching england lose to spain
still apex
what's the score
neon epoch
1-0
neon atlas
1-0 for the better team
still apex
so spain right
neon epoch
this guy gets it
neon atlas
yea, spain is winning rn
still apex
thank god
neon epoch
(s)painful to watch
last bear
Any webdevs in chat
an announcement page on our website that mirrors the discord (or maybe just forum?) announcements would be nice
neon atlas
still apex
sounds like a <@292616490958454795> moment
wat
neon atlas
sounds like a fun project for you, you are a webdev now
fair river
we need you, powerdev_gamer
neon atlas
webcas_gamer
still apex
i have awesome web dev skills yes see my readme
don't enter if you have medical issues
i am not responsible
spice temple
Pulling messages out of discord sounds fun
neon atlas
convincing, exactly what we need
spice temple
Forum is easier
fair river
but yeah like a smol box that pull message from a place
neon atlas
should we then have a forum -> discord flow?
still apex
should be easy with a bot
small harbor
yeah forum -> discord would probably be a better move
since you can atleast use XF2 API then to pull posts
last bear
Manually copy pasting some of the dev/admin announcements also isn't too bad, on top of forum posts. but even just forum posts alone would be enough
or just manual
neon atlas
kenny signing up to do that 
last bear
I'm already the announcement monkey so that'd be fine
but if pulling forum posts is easier-ish than that, then that's de way
spice temple
It would just basically be skinning the front page of the forum
drowsy zinc
maybe like a RSS feed style there? 10 second MSpaint job
man rss, so old
still apex
man rss, so old
like you
drowsy zinc
spice temple
https://i.imgur.com/mG2hyHD.png first two are Velocity (which I can't tell), thi...
the page doesnt include brigdier in any headline
radiant summit
@neon atlas review NOW
neon atlas
drowsy zinc
that updated picture has the paper-plugin.yml box ticked, that is going to confuse people
last bear
The Plugin remapping section in Paper Project Setup feels a bit out of place/not easy to understand for the beginners that would use that page
vocal halo
I mean it’s kind of plugin setup
opal flare
@still apex fix it
still apex
i didn't break it
last bear
It can be on that page, but rn I don't think any beginner would understand it at all
still apex
<@292616490958454795> fix it
wait what were u talking about
vocal halo
It can be on that page, but rn I don't think any beginner would understand it at...
Did people already come here and ask about it?
Like that specific part?
last bear
No but the entire section is doesn't mean anything to someone who has never done plugin dev/dev with internals/isn't aware of any different "mappings"
some clarification that it refers to using internals and that they dont need to worry about it otherwise is good enough, but that's needed
south thunder
Maybe Luck could PR some of their stuff? Spark docs are pretty nice
radiant summit
I mean spark has docs ^ so I assume what riley means is something more of a 'Paper is now using spark' type of stuff?
south thunder
Oh, that makes sense
opal flare
I mean spark has docs ^ so I assume what riley means is something more of a 'Pap...
basically that yeah - an overview of how Paper is moving to Spark, Timings is deprecated (and now disabled by default), links to Spark docs, etc
/cc @south thunder
an official docs page instead of various GitHub issues
drowsy zinc
could we get a build-pr-jar on the spark pr so I can check the configuration?
still apex
no
eager plover
it doesn't even build
drowsy zinc
I'm also not sure how to change the spark version as noted in the docs issue
I'll push what I have as a draft
opal flare
threw some comments at your PR @drowsy zinc
opal flare
and just FYI @drowsy zinc, "spark" should always be written in lowercase - that's how Luck brands spark
opal flare
(just wanted to explain my reasoning in case anyone wondered why 😄)
eager plover
SpARk
fair river
and just FYI <@504916819987922954>, "spark" should always be written in lowercas...
Wait so grammar question. Even if spark is the beginning word?
- spark report should be sent
Vs - Spark report should be sent (wrong) ??
radiant summit
depends which language grammar you ask I guess
I'd uppercase it at the start of headers and sentences but that's just me
opal flare
Wait so grammar question. Even if spark is the beginning word?
- spark report ...
I’d say spark, but @empty anchor can make the final decision
fair river
Yeah I am interested to know because I am making the canned message for help channel use.
drowsy zinc
the lowercase heading is a bit meh, I think it would look better in backticks
still apex
paper now it is
drowsy zinc
Paper isn't in backticks
Paper also starts with a capital P
empty anchor
Lowercase always :)
fair river
I see. I will make sure that’s the case. Thank you
still apex
no problem
still apex
Wait so grammar question. Even if spark is the beginning word?
- spark report ...
why would you start a sentence with that
scenic gull
"Spark reports should be sent to the paper-help channel" as example.
distant swan
"Spark reports should be sent to the paper-help channel" as example.
"The paper-help channel should receive your spark reports" 
scenic gull
ehhh
vocal halo
The reports generated with spark should be sent to the help channel
south thunder
Send the generated spark report to paper-help
fair river
I will release the canned message once doc page is done.
I need to fix all Spark references on paper chan guide too 
drowsy zinc
spark*
fair river
See what I mean 
my phone auto correct to that too 
still apex
fix it
fair river
While we are at the topic of wanting an actual page for stuff like spark migration. How about a page to explain the remapped folder? @last bear currently. Our FAQ just link to your initial announcement on the forum.
outer elkBOT
Starting in version 1.20.6+, Paper uses Mojang mappings at runtime. Any plugin that still uses Spigot names for internals will be automatically remapped to work on Paper (Read more). The folder is used to store the remapped plugins. You should leave it untouched!
fair river
It can probably be combined as well since currently the Spark page felt empty
opal flare
I wish that folder wasn’t inside of the plugins directory
scenic gull
Move it before experimental's removed! 😄
fair river
I wish that folder wasn’t inside of the plugins directory
Cc: @random pollen 
make it happen jmp
lilac edge
was there talks of it being in the cache folder?
opal flare
It'd be nice to do something similar to Fabric, where there's a .paper root folder, and things like remapped plugins would be in there, along with anything else that is only "cached"
like so
last bear
Can we add Hangar to https://docs.papermc.io/paper/reference/paper-plugins as a sort of "if you are looking for plugins that run on Paper, ..."? It's the first result on google when you search for "paper plugins"
@spice temple and that's an seo moment
spice temple
Haha
So maybe just gotta promote that better by choosing better headlines?
Like changing that headline to find paper plugins
Maybe i should spend some time in search console and write down some findings
But yeah, we are the authority for "paper" and the page you link has a title of paper plugins, of course google will pick that
We should change the headline to developing paper plugins or something
last bear
Yeah
drowsy zinc
it's not a developer reference tho
that's a different page
maybe someone could try adding the keywords front matter metadata to some pages and see what effect it has on the seo
opal flare
fyi: spark docs PR needs updating for new system property
opal flare
PR description of https://github.com/PaperMC/Paper/pull/11093 has new configuration options. No more system properties.
drowsy zinc
I just pushed the property doc
opal flare
I just pushed the property doc <a:omegaroll:779885760278036530>
❤️
Don't copy my configuration comments exactly. They can be worded more cleanly, if you can :P
drowsy zinc
👍
drowsy zinc
I looked at the PR on spark's repo; will the spark configuration be in a plugin folder forever or is that bound to change?
opal flare
@empty anchor ^
drowsy zinc
just asking in advance so I don't have to redo the doc if it ends up changing 
drowsy zinc
I think it'd be better for it to stay in the plugins dir, since then you won't have fragmented configuration if someone opts to use the plugin instead of the bundled version
vocal halo
Will spark paper be a handled like a plugin?
scenic gull
All your questions and more, answered here: https://github.com/PaperMC/Paper/pull/11093
vocal halo
Well a simple yes or no would help me more I would like to base my suggestion off of it.
I am aware of that pull request and discussion and that luck added a spark-paper module to the plugin. There is limited information about how spark-paper works. Because someone said that people will be able to update spark separately from paper i would like to know if that’s said spark-paper thing or if it’s being developed separately.
drowsy zinc
spark-paper is what is actually in paper
you can toggle the spark.prefer-spark-plugin config option and it will load spark from a plugin jar, if there is one
so if you wanted to use a newer version than the one that is bundled, you toggle that option and put the new spark you downloaded as a plugin into the plugins dir
vocal halo
Alright that clarifies a lot thanks
That means having the config in the plugins folder is probably the best yeah
drowsy zinc
though if someone switched to a newer version, the plugin changed the config, and then they switched back to the bundled one, that could be a problem depending on what changed
vocal halo
My initial idea was to put it in the /config dir since I thought spark-paper would be a plugin so just have that read config from the /config dir
vocal halo
though if someone switched to a newer version, the plugin changed the config, an...
But yeah you are right on that one.
vocal halo
<@&748618676189528155>
mental sleetBOT
(669a362f6ed5010734cf17ca) // @mint arrow (@ichhabebezahlt / 396658803237584896) has been banned by @neon atlas (202850073812402177)
Reason: Compromised account - steam scam
radiant summit
@neon atlas how does one uppercase Ban
neon atlas
drowsy zinc
mental sleetBOT
(669a5b866ed5010734cf17cb) // @deep pawn (@valguy / 892308773899739147) has been banned by @radiant summit (451779815415218177)
Reason: compromised account
neon atlas
was hangar not enough /s 
spice temple
Pff, I only added a partly invalid sitemap
opal flare
@drowsy zinc @still apex spark.prefer-spark-plugin configuration option is being removed, moving to paper.preferSparkPlugin system property. want to update the docs? :D
opal flare
thanks powercash
drowsy zinc
uhm there's still a link to the configuration key on the profiling page
that should be updated @still apex
still apex
enable the
paper.preferSparkPlugin
global configuration option.
what do i english this into
enable the .. system property?
opal flare
to true
still apex
becaauuuseee?
eager plover
Because it pisses me off when using the search drags me to the 1.18 page
drowsy zinc
someone needs to fix the website search yea
still apex
what'd you think of my branch name
eager plover
branch?
opal flare
last time I trust powercash :(
still apex
@drowsy zinc how tf do you properly link them
drowsy zinc
don't you need a file extension for relative stuff
drowsy zinc
get good
drowsy zinc
lgtm
still apex
Is promoted the thing that means whether it's on the main downloads page?
downloads api
opal flare
no
still apex
what is it used for?
spice temple
It's only used for velocity I think
opal flare
used for nothing currently
eager plover
There was a few promoted velocity builds
it was mostly about pinning actual releases, just, we got stuck in an extended snapshot phase
hopefully should be doing a release soon, especially now that chat sync is fixed, idk anything off the top of my head for 3.3
opal flare
It was a joke!
drowsy zinc
opal flare
😠
neon epoch
oh lol
still apex
@neon epoch i can recommend you a therapist
neon epoch
thats not my fault
opal flare
I look multiple times now and don't see why that is happening
vocal halo
Is this unix/linux or windows? I know a silly take but maybe the ssh agent didn’t start for some reason?
That’s the only thing I can think of
neon epoch
Is this unix/linux or windows? I know a silly take but maybe the ssh agent didn’...
Winders
I made both my PRs thru the GitHub web UI
the lengths I go to for paper
still apex
should it link to the spark discord or here?
opal flare
should link here
still apex
done
opal flare
thanks
last bear
I will put my hands deep into my pockets and pay $5 to whoever removes a bit of that giant empty space around the "main" content without making it look worse or inconsistent across pages https://i.imgur.com/y0kdyrB.png https://i.imgur.com/0jBLCCa.png
fair river
put paper chan there
raw breach
did someone say money?
raw breach
kenny rich confirmed?
still apex
put paper chan there
beautiful https://i.imgur.com/UrnBw4r.png
lmk where i can send my paypal to
serene vault
take a in-game group photo and put it as the background there 
drowsy zinc
beautiful https://i.imgur.com/UrnBw4r.png
why is she so crisp
still apex
took it from eternity website
neon epoch
Shrunk it: https://site-git-fork-olijeffers0n-change-padding-sizes-papermc.vercel.app/ - not sure how i feel but i think i like it more
last bear
Try adding a bit of it back
neon epoch
last bear
one issue is also having some kind of indication that you can scroll down on the main page
at least on a "standard" 1080p display
neon epoch
If i add some back, it makes it worse
I do like this amount a lot tho ^
its slightly more than what i pushed
also, shouldn't folia be there?
How about this
neon epoch
Shrunk it: <https://site-git-fork-olijeffers0n-change-padding-sizes-papermc.verc...
try again ^
lilac edge
contribute page isn't aligned
last bear
The last looks a bit too squashed/weird with top and bottom padding being different. But adding folia there sounds good
I’m off to bed, so on mobile now so I can’t check the deployed version
radiant summit
https://github.com/PaperMC/docs/pull/439#event-13497343880 thanks for the assignment Ollie
still apex
no problem
why did you link to a message in hangar moderation there
@radiant summit ??!
radiant summit
why did you link to a message in hangar moderation there
how do you know the channel name huh
still apex
wouldn't you like to know
neon epoch
<https://github.com/PaperMC/docs/pull/439#event-13497343880> thanks for the assi...
Ur so welcome ☺️
spice temple
We should just not show descriptions then
But can't we fetch them from the other file?
Since we have descriptions for these options
drowsy zinc
ya
drowsy zinc
love repetition
still apex
should be one page for both
still apex
oh
spice temple
Idk, descriptive headlines are good
drowsy zinc
I'd call it overly repetitive
especially if the entire page is about configuring forwarding
vocal halo
But having just Fabric, Sponge, Spigot in the header looks weird I guess. Do you have a better suggestion?
drowsy zinc
no not really
we can explore it in a PR, the h1's casing and the heading levels there need to be fixed anyways
vocal halo
So many different shades of purple now lol
fair river
That’s pink!
still apex
you’re pink
vocal halo
we can explore it in a PR, the h1's casing and the heading levels there need to ...
TOC looks weird but idk other than that the headings are good enough. And yeah h1 is wrong at some of them.
toxic path
what?
still apex
what?
lilac edge
what?
drowsy zinc
what?
steady fulcrum
what?
still apex
the papi expansion should be documented
or well, just that it's required now and how to install
last bear
Easy pr for https://docs.papermc.io/paper/dev/component-api/introduction#minimessage: some method in a util class that's then referenced via a static import in an example use, to show that you can easily make it even less verbose
drowsy zinc
I'll do it later unless someone else wants to do it
last bear
How about this
This here would be a middle ground https://i.imgur.com/jAuSmN6.png
I really don't know how to both show that you can keep scrolling but also not make it too squashed/have it take away from the main focus
still apex
@drowsy zinc dunno if i like the mm one
neon epoch
Can we please get in the habit of actually commenting on GitHub if we have actual objections. I am fed up of merging PR’s only to find issues in discord 😭
neon epoch
This here would be a middle ground https://i.imgur.com/jAuSmN6.png
Yeah I’m at work tonight but can get back to this tomorrow
last bear
You could maybe split the util and call up into multiple code blocks
drowsy zinc
I didn't think it'd look good
neon epoch
I personally thought it looked good
last bear
should be fine then
neon epoch
the sizing is consistent across all pages apart from home screen now
i'm not too bothered by the change when you go from home -> other page but its not ideal
last bear
Hmm it should ideally stay consistent
I think to get it any better than the homepage in your current changelist it needs more than padding changes, but at least it's slightly better than the current
it truly is a science
fair river
Opinion needed
Currently, I am going through all the @outer elk commends to reorganize it.
Do we want a page on our doc site for /895 ? it's a catchall for troubleshooting player kicked/timeout/high ping issue.
https://github.com/PaperMC/Paper/issues/895#issuecomment-372175216
fair river
yes something like that, I thought we want to replace those page in issue comments into its own stand-alone page.
We did that for the /dupes
spice temple
we can have a faq page on the docs
add some structured data/jsonld/microdata and then google/seo goes :stonks:
drowsy zinc
it could probably go here https://docs.papermc.io/paper/basic-troubleshooting or here https://docs.papermc.io/paper/faq
spice temple
oh we already have an faq page?
lemme just drop this here then https://developers.google.com/search/docs/appearance/structured-data/faqpage
fair river
@still apex I trust this in your hand 
jagged pecan
semi-related to seo, (but otherwise offtopic) ive abused my univerities free student web space, which was on their main domain, for seo reasons for a student event lmao
like added basically a single purpose page with the keywords, some meta tags + a link to the actual site
registered in the google search console + told it to scrape the url, and we were instantly top results
fair river
Read above 
drowsy zinc
ok
ancient quiver
lemme just drop this here then https://developers.google.com/search/docs/appeara...
Your site must be a health or government site. It must also be well-known and authoritative.
mental sleetBOT
(66a4c1c06ed5010734cf1811) // @hexed holly (@aluo / 266192716914884609) has been banned by @last bear (259465250716254210)
Reason: Scam
still apex
May be worth having a small page doc thing explainging the attribute item flag item component stuff
drowsy zinc
uh what
prisma ember
Hello, I just noticed this.
Should the light setting be added to the vanilla page one ?
spice temple
whats the gameplay impact of that?
prisma ember
whats the gameplay impact of that?
To be honest idk. Maybe it could had been just a miss (that's why I asked)
spice temple
Imho that page should only document stuff which we know is important to some users
Else people just blindly copy paste stuff and loose out on benefits paper can provide
drowsy zinc
I asked about that on the sprint interruption bug PR and ollie felt the same way
echo canyon
Hello, I just noticed this.
Should the light setting be added to the vanilla pag...
I think that setting is actually unused currently? I know there's a couple settings that still exist that serve no purpose
prisma ember
I think that setting is actually unused currently? I know there's a couple setti...
So, should it be precised on the wiki when a field is unused and since it has been ?
still apex
should Docs Team be added to the website team page?
still apex
was doing that
shut delta
Maybe add Ollie to both?
drowsy zinc
should Docs Team be added to the website team page?
🙏
still apex
Maybe add Ollie to both?
@drowsy zinc opinion?
drowsy zinc
idk, let's ask him
opal flare
people only appear once on the team page
for their highest-ranked (according to discord sidebar) role
opal flare
correct
drowsy zinc
only one ollie
opal flare
@ me if you send in a PR
still apex
fyi i rebased the cloudflare one
neon epoch
What the hell I want to appear on every team
still apex
maybe when you get leadership
Are moderators supposed to be under triage? https://papermc.io/team
@radiant summit don’t be rude
opal flare
Are moderators supposed to be under triage? https://papermc.io/team
above
also, random thought
maybe we can put the coloured planes beside the role name?
still apex
not a fan
radiant summit
how much rainbow? yes
still apex
@drowsy zinc what do you want your name to be?https://i.imgur.com/pZmiKsR.png
drowsy zinc
my real username
still apex
which is
drowsy zinc
my real username on discord and github
zlataovce
it does look funny if it's the same thing repeated three times though
not sure what else would be usable as my name, it's probably fine
radiant summit
złota owca
opal flare
zlata owo
drowsy zinc
vocal halo
Microsoft Publisher Color
still apex
opening draft pr for preview
opal flare
@still apex can you sort the members of the triage team?
opal flare
they are existing
opal flare
<@292616490958454795> can you sort the members of the triage team?
@still apex
still apex
am doing
opal flare
also, NMF should not be on two teams on that page
still apex
alreayd fixed (:
opal flare
alright
spice temple
Vercel makes sure of that
Man, I fucking hate gate keepers, especially if they want to gatekeep foss
Moving to Vue is always an option ^^
opal flare
try now @still apex
still apex
Did anyone else get a new role?
also
The community team keeps our community a safe and vibrant space.
instead of
Moderators keeps our community a safe and vibrant space.
?
opal flare
yes
still apex
https://i.imgur.com/0PTQ48W.png vercel wants to stay
opal flare
ENOENT: no such file or directory, scandir '/home/runner/work/website/website/build'
south thunder
Did anyone else get a new role?
also
> The community team keeps our community a ...
Where did the vibrant part come from?
opal flare
also
The page you've requested has been built using @cloudflare/next-on-pages, but hasn't been properly configured.
no nodejs_compat compatibility flag set
love that
(fixed)
the action probably needs to use something similar to what cloudflare is using:
still apex
Think that’s something you need to do or idnhVe to create a PR but that’d have to wait a few hours
vocal halo
isnhVe?
vocal halo
Been there, done that
jagged pecan
what, waking up?
still apex
Think that’s something you need to do or idnhVe to create a PR but that’d have t...
@opal flare (:
opal flare
hm?
still apex
the action probably needs to use something similar to what cloudflare is using:
was in reply to this
opal flare
ah
I don't have time to deal with cloudflare/vercel/etc nonsense right now
so it can wait at this point
inner kestrel
can someone explain to me what the cloudflare pages error in https://github.com/PaperMC/docs/actions/runs/10229027119/job/28302192053?pr=359 means
spice temple
Don't worry about it
drowsy zinc
oof, that's my logic for the base url acting up
drowsy zinc
@inner kestrel it should start working as expected if you pull the latest changes
still apex
scoop breaking everything again smh
drowsy zinc
silence powerwash
radiant summit
staff for a few weeks or so and already rude to powercash, that's the spirit
craggy cedar
I don't think there's a better channel for this: what does the "promoted" boolean in the API response for a build mean? it seems to be false for every build...
craggy cedar
oh ok. but for paper it doesn't matter?
eager plover
it's not used for paper because we've never had "stable" builds
spice temple
RB 0.1 Moment
opal flare
@still apex what is left for https://github.com/PaperMC/website/pull/109
opal flare
https://papermc.io/ is now hosted on Cloudflare Pages.
(production; previews are currently non-functional)
drowsy zinc
still apex
why did you break previews again smh
opal flare
why did you break previews again smh
I didn't, security did
still apex
did you see the PR from that person
opal flare
the nice thing is that production website no longer needs to wait for someone to manually deploy it
I did
not dealing with it today
previews are a... thursday thing
what is left on https://github.com/PaperMC/website/pull/109 powercash?
still apex
that you’re still as leadership
opal flare
ok