#docs-website | PaperMC | Page 17

lean venture Nov 14, 2025, 10:26 PM

#

is it just a decompiler?

#

or am I missing smt

random pollen Nov 14, 2025, 10:26 PM

#

theres docs linked in one of the info things in the action menu

drowsy zinc Nov 14, 2025, 10:26 PM

#

$lib/tab and $lib/components/pane/pane.svelte

#

wouldn't take an example of that code lol

lean venture Nov 14, 2025, 10:27 PM

#

god, whoever said kotlin sucked to reverse engineer was not joking

random pollen Nov 14, 2025, 10:27 PM

#

you might notice that actually has quite a bit of resugaring lol

drowsy zinc Nov 14, 2025, 10:28 PM

#

drowsy zinc wouldn't take an example of that code lol

it was written with svelte 4 reactivity originally and it also has handling for dumb stuff like destroying and recreating the entire tab's component lazily

#

$lib/tab not task bruh

random pollen Nov 14, 2025, 10:29 PM

#

yeah I figured lol

lean venture Nov 14, 2025, 10:31 PM

#

random pollen you might notice that actually has quite a bit of resugaring lol

resugaring?

drowsy zinc Nov 14, 2025, 10:31 PM

#

any other decompiler would output a java approximation but that's vineflower which has a kotlin plugin, so it outputs kotlin-ish

drowsy zinc Nov 14, 2025, 10:35 PM

#

lean venture is it just a decompiler?

it's recaf but read only and in the browser Trollface

lean venture Nov 14, 2025, 10:49 PM

#

xD

jagged pecan Nov 14, 2025, 11:07 PM

#

lean venture resugaring?

The process of re-adding all the syntactic sugar that the compiler eats

random pollen Nov 15, 2025, 2:21 AM

#

drowsy zinc $lib/tab not task bruh

what are you using virtua for

#

funny how I looked in your package json and half the libs is stuff I normally use

drowsy zinc Nov 15, 2025, 9:00 AM

#

random pollen what are you using virtua for

search results

#

it started to lag with minecraft loaded in

random pollen Nov 16, 2025, 3:22 AM

#

https://papermc-feat-resizable-sideb.diffs.pages.dev/?github_url=https%3A%2F%2Fgithub.com%2FPaperMC%2Fdiff-viewer%2Fpull%2F45

#

didn't add anything like the tabs in slicer yet but I got sidebar resizing working pretty good

#

one thing I wish paneforge had was the ability to make a pane avoid resizing when the container resizes

#

so that if I shrink or grow the window the sidebar won't change size to keep proportion

#

it would only shrink if the window got smaller than it

random pollen Nov 16, 2025, 3:41 AM

#

https://github.com/svecosystem/paneforge/issues/91

drowsy zinc Nov 16, 2025, 9:54 AM

#

looks cool

#

I think we're pushing what paneforge was designed for a little bit

random pollen Nov 16, 2025, 11:45 PM

#

yeah maybe

#

I actually found kind of a cursed solution

#

// Maintain sidebar size when resizing window
watch.pre(
    () => this.windowInnerWidth,
    (newValue, oldValue) => {
        if (oldValue !== undefined && newValue !== undefined && this.sidebarPane) {
            const oldPx = (this.sidebarPane.getSize() / 100) * oldValue;
            const newProportion = this.getProportion(oldPx, newValue);
            this.sidebarPane.resize(newProportion);
        }
    },
);

#

it still glitches a little bit but by using pre it doesn't lag at least

#

~~actually it's pretty much perfect when sidebar is on the left, only glitchy on the right~~ the sidebar fidgets when you resize the window from the opposite side it's docked to

random pollen Nov 17, 2025, 1:52 AM

#

random pollen https://papermc-feat-resizable-sideb.diffs.pages.dev/?github_url=https%3A%2F%2Fg...

updated with that change, still one thing I'm not happy with mentioned in the TODO

#

but I think I can live with it for now

pliant canopy Nov 17, 2025, 9:40 AM

#

Is there any way we can make these messages not appear? I know that on the docs github they don't; maybe apply the same change to the website webhook? Idk how that is managed

burnt ice Nov 17, 2025, 4:47 PM

#

@opal flare

wispy python Nov 17, 2025, 10:52 PM

#

#paper-dev message

#

?

lean venture Nov 18, 2025, 12:09 AM

#

wispy python https://discord.com/channels/289587909051416579/555462289851940864/1440109499951...

does this look like the appropriate channel?

drifting flume Nov 18, 2025, 4:09 AM

#

Hey, what can be contributed to the paper docs?
I think this section could use a little more info on database frameworks/libraries like jooq or exposed for a more type-safe approach or help with auto-generated code, instead of handling everything with raw java.sql
Is that something that would fit into the docs?
https://docs.papermc.io/paper/dev/using-databases/

Using databases | PaperMC Docs

Databases are the recommended way to store a large amount of data. This guide outlines a few key details.

fair river Nov 18, 2025, 4:19 AM

#

drifting flume Hey, what can be contributed to the paper docs? I think this section could use a...

Hello and welcome to Paper! I think the idea is nice but let's wait till the doc team members to see what their thoughts are paperOhhh

drifting flume Nov 18, 2025, 4:21 AM

#

Sure based

wispy python Nov 18, 2025, 5:01 AM

#

lean venture does this look like the appropriate channel?

Yeah, the docs might contain a mistake

#

Read the conv

spice temple Nov 18, 2025, 7:22 AM

#

I think mentioning them and explaining them with like a sentence or two is fine, I wouldn't explain how to use them, only link to relevant documentation

#

might aswell explains ORMs and mention hibernate and throw jdbi into the mix, but can always be expanded

pliant canopy Nov 18, 2025, 8:27 AM

#

Indeed, I share Mini's opinion. We don't really want to go in-depth into not Paper specific concepts since there are plenty of docs explaining how to use databases with Java already and there is no need to clutter our docs with that. But mentioning it so that people become aware is good

#

They can do their own research afterwards and find much more specific docs on those subjects if they were to just look it up themselves

eager plover Nov 18, 2025, 12:34 PM

#

Most of the goal of the "using a DB" page was just to provide a simple "getting started" type of deal, documenting 3rd party projects in there is just extra burden especially when those providers already have good docs, would generally lean more towards noting some of the caveats of using a DB in paper, "it works just like a normal java app but you might want to be mindful of were you do your IO" type stuff

pointing towards common solutions is fine, if we ever get an example repo running we might even allow contributions for such (but, such does come with the fear of this stuff falling out of date)

drifting flume Nov 18, 2025, 1:51 PM

#

Yh, the idea I had was to basically mention those tools, the advantages over java.sql and provide a snippet comparing how a query looks, enough for people to know the existence of said tools before forwarding them to the actual documentation
It think it would be slightly shorter than the SQL Injection section

eager plover Nov 19, 2025, 1:50 AM

#

I suck at english, I'm generally concerned over the wording of the PR for ^ in that it feels somewhat loaded and maybe kinda vague; I worry it's maybe overly pushy for tools we can't really support?

#

In wider terms of that page, the nature of being useful for beginners, I think a fair pressing need for expansion exists in ecosystem specifics, such as avoiding your IO on the main thread, but it also feels that every few months I have a discussion of "you should probably avoid caching eco" type discussions

drifting flume Nov 19, 2025, 1:58 AM

#

I made it somewhat vague to not make it sound like advertising for those tools

#

Plus trying to explain the context of those tools, but at the same time not diving too much into it

eager plover Nov 19, 2025, 2:01 AM

#

I'm semi worried that the way in which it's worded kinda makes it feel like it's an imperative for developers to start using those tools

drifting flume Nov 19, 2025, 2:02 AM

#

And I tried to avoid sounding like that despair

eager plover Nov 19, 2025, 2:02 AM

#

I did ask chatgpt because I suck at language, it generally suggested this which feels a bit more natural;

When working with SQL, developers often need to balance security, type-safety, and code readability. Using a library can help handle these concerns automatically, letting you focus on the business logic rather than the low-level SQL details.

Libraries take different approaches, such as SQL builders or ORMs. Popular options in Java include JDBI and JOOQ.

drifting flume Nov 19, 2025, 2:03 AM

#

For example, I avoided terms like "popular" because I truly don't know how popular these tools are amongst plugins devs

#

Referring to the last line btw

eager plover Nov 19, 2025, 2:04 AM

#

I mean, those are popular options for people wanting to use those types of tools in java

drifting flume Nov 19, 2025, 2:04 AM

#

The first paragraph does look better, I'll try to word something like that

eager plover Nov 19, 2025, 2:05 AM

#

I'm not 100% on the chatgpt output, but I think it leans in a nicer direction, I'm generally pondering what the other docs people think as my English made my English teacher upset 😄

drifting flume Nov 19, 2025, 2:09 AM

#

I mean, in general yh, those tools are definitely popular, I'm just not so sure how much they are in the context of minecraft plugins
Plugins I know using jooq are relatively few, can't say much about jdbi tho, didn't payed much attention to it

#

I'll also wait what the rest of the team says. but will be trying to follow a similar structure to the sample you sent 🫡

serene vault Nov 19, 2025, 2:34 AM

#

We also mention Hikari and even have an example for it.
I feel like mentioning some commonly used tools is fine, but I would remove the JOOQ example - that is something people can then look up if they decide on a tool. e.g. I would prefer JDBI there

#

And maybe remove the " leaving the developer with clean, secure and readable code." part. that sounds too much like ChatGPT

drifting flume Nov 19, 2025, 2:49 AM

#

Don't tell me I talk like chatgpt despair

#

I'll have to look at some jdbi examples, I mostly use jooq and exposed

#

-# ^ Forget it I just understood what you meant about jdbi

#

I guess providing an example for both would bloat the doc, so that's out of question. I'll see if I can figure out a way to give a peek into how tools reduce the code compared to plain jdbc

serene vault Nov 19, 2025, 2:59 AM

#

Yeah I didn't mean that you should add more examples, I think just directing people to the tools should be good enough. e.g. they all have some examples in their docs or similar

drifting flume Nov 19, 2025, 2:59 AM

#

Dw, I understood I should remove them

drifting flume Nov 19, 2025, 3:23 AM

#

I took a different approach this time.
I removed the part mentioning sql-builders and orm, plus focused on the advantages of these tools in the context of what is already on the docs (connecting with hikari, building queries, keeping an eye for sql injections) and added a bit about parsing, since what is fetched from the db will most likely be used in an object.
It is extremely short this time (this is the whole section), what do you think? I also tried following a similar wording to the example from ecat

## Database tools

Given the complexity of working with databases (managing connections, building and securing queries, or just parsing the data) several tools
exist in the world of Java to leverage this work.

Some plugin developers use tools like [JDBI](https://jdbi.org/) or [JOOQ](https://www.jooq.org/doc/latest/manual/), which are lightweight
and easy to use.

#

Since there are no examples this time, maybe I could mentioned exposed as well

#

Small fix because I felt it ended up too dry

## Database tools

Given the complexity of working with databases (managing connections, building and securing queries, or just parsing the data) several tools
exist in the world of Java to leverage this work.

Some plugin developers use lightweight tools like [JDBI](https://jdbi.org/), [JOOQ](https://www.jooq.org/doc/latest/manual/) 
or [Exposed](https://www.jetbrains.com/help/exposed/get-started-with-exposed.html), which take care of all the heavy lifting, 
allowing the developers to focus on their plugins rather than the database.

blissful nebula Nov 20, 2025, 1:50 PM

#

what is paper mc

twilit fog Nov 20, 2025, 2:00 PM

#

blissful nebula what is paper mc

not a #docs-website question, ask in #general

pliant canopy Nov 20, 2025, 3:11 PM

#

How do you even end up here if you have no idea what it is

#

And this description here is basically everywhere where you can get the invite link from

jaunty garnet Nov 21, 2025, 11:01 AM

#

blissful nebula what is paper mc

Bro using vanilla core since his born 💀

scenic gull Nov 21, 2025, 5:40 PM

#

Let's keep on topic.

hearty briar Nov 21, 2025, 6:47 PM

#

now that adventure and paper docs are merged, perhaps it would be good to merge the GlobalTranslator docs in the Paper docs and the MiniMessage translator ones under an Adventure i18n section

#

I always end up linking the two when people ask about server-side translations so I feel like they should just be one honestly

lean venture Nov 21, 2025, 7:05 PM

#

hearty briar now that adventure and paper docs are merged, perhaps it would be good to merge ...

what's globaltranslator? am I missing smt?

odd harborBOT Nov 21, 2025, 7:05 PM

#

https://docs.papermc.io/paper/dev/component-api/i18n/#globaltranslator

Internationalization | PaperMC Docs

How to use Adventure's internationalization.

hearty briar Nov 21, 2025, 7:05 PM

#

lean venture what's globaltranslator? am I missing smt?

^

rain ocean Nov 21, 2025, 11:55 PM

#

Is it just me or does every doc page switch cause the entire page to reload and the sidebar has to redo its long animation? I tried disabling my extensions, and even switch browsers. I haven't seen other starlight astro docs have this issue

drowsy zinc Nov 21, 2025, 11:57 PM

#

the entire page reloads because it's navigating, it's not a spa

#

the animation is us scrolling to the active page because the sidebar is too long

rain ocean Nov 21, 2025, 11:58 PM

#

Also on slower internet, it seems the font isnt being cached, cause the entire page content is twitching every single time u switch pages

rain ocean Nov 21, 2025, 11:58 PM

#

drowsy zinc the animation is us scrolling to the active page because the sidebar is too long

why do no other astro docs have this problem then?

drowsy zinc Nov 21, 2025, 11:58 PM

#

they don't scroll?

rain ocean Nov 21, 2025, 11:59 PM

#

?

#

i just tested it on the starlight official docs

#

and made my window small

#

they dont have this problem

#

the scroll animation is cool for very first page load, but should not be a thing when switching pages

#

here's the poor accessibility w/ the page shifting due to the font changing on every page swap

lean venture Nov 22, 2025, 12:05 AM

#

yeah the font issue is indeed bad

drowsy zinc Nov 22, 2025, 12:07 AM

#

rain ocean they dont have this problem

they don't have this problem because they don't scroll the sidebar programmatically, the shift depends on your browser's handling of scrollIntoView when the element is actually visible, I would accept a PR to manually check for that

drowsy zinc Nov 22, 2025, 12:08 AM

#

rain ocean here's the poor accessibility w/ the page shifting due to the font changing on e...

what level of throttling is this

rain ocean Nov 22, 2025, 12:09 AM

#

drowsy zinc what level of throttling is this

i set it to 4g fast, but i have this issue anytime im at my parents place

#

and they dont have crappy internet, but its not fiber or anything

drowsy zinc Nov 22, 2025, 12:11 AM

#

I'll try to reproduce it

rain ocean Nov 22, 2025, 12:12 AM

#

im assuming this is caused by font loading

#

and my guess is the browser is not caching it

drowsy zinc Nov 22, 2025, 12:13 AM

#

I don't see any shift on my default connection speed in my firefox instance since the font & logo have been preloaded

#

if you don't have the issue on the main site that also uses the poppins font, just embedding the font into the stylesheet might be our best bet

rain ocean Nov 22, 2025, 12:16 AM

#

well the mainsite, u dont click around on pages with the same page structure as u would on the docs site, so its much harder to notice

#

but the mainsite also has the problem

#

the issue is on the font assests ur giving a no cache header, there shouldnt be a need to redownload the font on every single page loads, or well any of these assests on every page load

#

drowsy zinc Nov 22, 2025, 12:26 AM

#

yea the main site doesn't have the same rules as docs do

#

I thought it embedded the fonts in the stylesheet though, might be pre-astro rewrite behavior

spice temple Nov 22, 2025, 5:56 AM

#

rain ocean

That is a request header, you set that. I cant check myself right now, but by default devtools disable caching if open

wispy python Nov 22, 2025, 12:19 PM

#

[07:17:27 ERROR]: [StarRaid] Uncaught exception in scheduled task
java.lang.IllegalStateException: Asynchronous getNearbyEntities!
at org.spigotmc.AsyncCatcher.catchOp(AsyncCatcher.java:10) ~[paper-1.21.10.jar:1.21.10-113-9fc21bc]
at org.bukkit.craftbukkit.CraftWorld.getNearbyEntities(CraftWorld.java:979) ~[paper-1.21.10.jar:1.21.10-113-9fc21bc]
at org.bukkit.craftbukkit.CraftWorld.getNearbyEntities(CraftWorld.java:974) ~[paper-1.21.10.jar:1.21.10-113-9fc21bc]
at org.bukkit.World.getNearbyEntities(World.java:1681) ~[paper-api-1.21.10-R0.1-SNAPSHOT.jar:?]
at org.bukkit.World.getNearbyEntitiesByType(World.java:1114) ~[paper-api-1.21.10-R0.1-SNAPSHOT.jar:?]
at org.bukkit.World.getNearbyEntitiesByType(World.java:1068) ~[paper-api-1.21.10-R0.1-SNAPSHOT.jar:?]
at org.bukkit.World.getNearbyPlayers(World.java:987) ~[paper-api-1.21.10-R0.1-SNAPSHOT.jar:?]
at com.destroystokyo.paper.ParticleBuilder.receivers(ParticleBuilder.java:247) ~[paper-api-1.21.10-R0.1-SNAPSHOT.jar:?]
at com.destroystokyo.paper.ParticleBuilder.receivers(ParticleBuilder.java:194) ~[paper-api-1.21.10-R0.1-SNAPSHOT.jar:?]
at com.destroystokyo.paper.ParticleBuilder.receivers(ParticleBuilder.java:148) ~[paper-api-1.21.10-R0.1-SNAPSHOT.jar:?]
at StarRaid-1.0.jar/dev.threeadd.feature.emp.EMPManager.lambda$startEMPTicker$1(EMPManager.java:67) ~[StarRaid-1.0.jar:?]
at StarRaid-1.0.jar/dev.threeadd.core.util.ScheduleUtil.lambda$wrap$0(ScheduleUtil.java:88) ~[StarRaid-1.0.jar:?]
at org.bukkit.craftbukkit.scheduler.CraftTask.run(CraftTask.java:78) ~[paper-1.21.10.jar:1.21.10-113-9fc21bc]
at org.bukkit.craftbukkit.scheduler.CraftAsyncTask.run(CraftAsyncTask.java:57) ~[paper-1.21.10.jar:1.21.10-113-9fc21bc]
at com.destroystokyo.paper.ServerSchedulerReportingWrapper.run(ServerSchedulerReportingWrapper.java:22) ~[paper-1.21.10.jar:?]
at java.base/java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1144) ~[?:?]
at java.base/java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:642) ~[?:?]
at java.base/java.lang.Thread.run(Thread.java:1583) ~[?:?]```
```Sends the particle to all receiving players (or all). This method is safe to use Asynchronously
Returns:
a reference to this object.```Wrongly documented as thread safe?

#

When I changed to sync it worked fine (see #paper-dev message)

#

twilit fog Nov 22, 2025, 12:33 PM

#

wispy python ```log [07:17:27 ERROR]: [StarRaid] Uncaught exception in scheduled task java.la...

create an issue on PaperMC/Paper

wispy python Nov 22, 2025, 12:33 PM

#

okay

twilit fog Nov 22, 2025, 12:34 PM

#

also what is ScheduleUtil

#

@wispy python your problem is you are using non async thread safe methods (namely receivers) on the ParticleBuilder in async

#

only spawn() method is async safe

#

    private static void spawnParticle(final Location someLocation) {
        ParticleBuilder explosionParticleBuilder = Particle.HAPPY_VILLAGER.builder()
            .location(someLocation)
            .offset(0, 10, 0)
            .count(0)
            .receivers(32, true);
        Bukkit.getAsyncScheduler().runNow(ParticleTest.getPlugin(ParticleTest.class), task -> {
                explosionParticleBuilder.spawn();
        });
    }

My method works fine

wispy python Nov 22, 2025, 12:48 PM

#

twilit fog ```java private static void spawnParticle(final Location someLocation) { ...

Spawn is documented wrong aswell tho

twilit fog Nov 22, 2025, 12:48 PM

#

wispy python Spawn is documented wrong aswell tho

it's not?

wispy python Nov 22, 2025, 12:49 PM

#

When running async it lags out my connection, we’re talking bout it in #paper-dev

twilit fog Nov 22, 2025, 12:49 PM

#

how is that documented wrong

#

the docs are factually correct, there is no mention of performance of what you're talking about

wispy python Nov 22, 2025, 12:53 PM

#

twilit fog the docs are factually correct, there is no mention of performance of what you'r...

#paper-dev message

scenic gull Nov 22, 2025, 3:52 PM

#

wispy python https://discord.com/channels/289587909051416579/555462289851940864/1441773470496...

If you see something wrong with our docs, submit a pull request to resolve it. This channel is about docs.papermc.io, the docs website.

wispy python Nov 22, 2025, 3:52 PM

#

oh mb

random pollen Nov 23, 2025, 4:09 AM

#

https://papermc-feat-line-selection.diffs.pages.dev/?github_url=https%3A%2F%2Fgithub.com%2FPaperMC%2Fdiff-viewer%2Fpull%2F49#web%2Fsrc%2Flib%2Fcomponents%2Fdiff%2Fconcise-diff-view.svelte.ts:R1255:R1268 svelte attachment api is cool (totally not just showing off the new line linking feature)

#

if someone wants to figure out how to make an action that comments a link to look at a diff-viewer PR diff in the PR's preview deployment that would be cool omegaroll

pliant canopy Nov 23, 2025, 11:58 AM

#

random pollen if someone wants to figure out how to make an action that comments a link to loo...

I cannot really test whether it works shrug , but this would be my proposal: https://github.com/PaperMC/diff-viewer/pull/50

GitHub

ci: add diff link to this PR using the deployment URL by Strokkur42...

vocal halo Nov 23, 2025, 12:46 PM

#

I think the wording is a bit weird

#

But nice idea

#

Makes perfect sense to have this imo

#

Although using a random paper commit could also be funny

pliant canopy Nov 23, 2025, 5:38 PM

#

vocal halo I think the wording is a bit weird

You've got a better suggestion?

#

I very much struggled with how I wanted to word it

lilac edge Nov 23, 2025, 8:22 PM

#

i'm surprised that refined cloudflare pages action doesn't give you control over the content of the comment

personally i would incorporate it within the cloudflare deployment message and include it as another column, e.g. "PR Diff Preview"?

The PR itself looks good, maybe "Click here to preview this PR's diff using it's deployment URL"?

pliant canopy Nov 23, 2025, 9:42 PM

#

lilac edge i'm surprised that refined cloudflare pages action doesn't give you control over...

I mean, we could do a fork of the cloudflare pages action, that's not a big problem

#

And thinking about it, I could probably also just straight up modify the comment

#

That actually sounds like a fun idea

neon epoch Nov 23, 2025, 10:31 PM

#

Be nicer if this was an action on the repo u wanted it to do

#

But generally a nice idea

lilac edge Nov 23, 2025, 10:38 PM

#

wouldn't make sense with the deployment url part since that's specifically for diff-viewer PRs

#

but in general using the diff-viewer website yeah i'd agree

vocal halo Nov 23, 2025, 10:52 PM

#

pliant canopy You've got a better suggestion?

maybe just "Click here to preview this PR's diff"

#

but yeah it would be nice to customize the message

south thunder Nov 25, 2025, 11:49 PM

#

I'm planning to make an extension to the troubleshooting guide with something along the lines of "I/someone can't join the server"
Is it fair game to copy a factoid into there if I point this out?
#paper-help message

jagged pecan Nov 27, 2025, 8:21 PM

#

@random pollen https://github.com/PaperMC/packages-maven-mirror/blob/master/src/index.ts#L40

Is this HEAD on the wrong line?

GitHub

packages-maven-mirror/src/index.ts at master · PaperMC/packages-ma...

Cloudflare Worker for proxying unauthenticated requests to GitHub Packages Maven - PaperMC/packages-maven-mirror

random pollen Nov 27, 2025, 8:30 PM

#

maybe

#

(probably)

#

it's supposed to respond to head requests

opal flare Nov 27, 2025, 8:35 PM

#

that is the wrong line for sure

jagged pecan Nov 28, 2025, 2:58 AM

#

Head: not-present (France)

wintry flint Nov 28, 2025, 6:43 PM

#

https://docs.papermc.io/paper/migration/#:~:text=Should you ever want to go back to Vanilla%2C follow the Vanilla Migration Guide closely%2C as manual changes will be required.
is that correct to say in English?

Migrating to or from Paper | PaperMC Docs

It's simple to migrate your server to or from Paper. This page will help you get started.

pliant canopy Nov 28, 2025, 6:57 PM

#

wintry flint https://docs.papermc.io/paper/migration/#:~:text=Should%20you%20ever%20want%20to...

Yeah, that is perfectly acceptable English grammar

vocal halo Nov 28, 2025, 7:04 PM

#

wintry flint https://docs.papermc.io/paper/migration/#:~:text=Should%20you%20ever%20want%20to...

what do you think is wrong with the sentence?

wintry flint Nov 28, 2025, 7:04 PM

#

vocal halo what do you think is wrong with the sentence?

English is not my native language.
Never saw this usage for "should"

scenic gull Nov 30, 2025, 4:58 PM

#

https://docs.papermc.io/misc/downloads-service/

You should always serve & use the stable builds. Experimental builds are prone to error and do not receive support.

Ampersand instead of and?
Experimental builds don't get support? But... we do help fix issues with them, that's how we fix many bugs!
Should this be modified from always serve to always offer by default (or similar phrasing) to encourage stable but acknowledge beta and alpha exist and some users might want to try beta at the very least?

eager plover Nov 30, 2025, 5:05 PM

#

Yea, the wording there looks kinda weird; Experimental builds come with a higher expectation on the user to know what they're doing,is I guess what is trying to be conveyed there

drowsy zinc Nov 30, 2025, 5:14 PM

#

the sentence should probably just be scrapped in favor of an entire section on the channel nomenclature

pliant canopy Nov 30, 2025, 9:54 PM

#

@sharp pivot is that property already inside of Paper, meaning it could be merged right now?

#

I cannot be bothered to validate it atm

sharp pivot Nov 30, 2025, 9:55 PM

#

it is

pliant canopy Nov 30, 2025, 9:56 PM

#

Great, all I needed to hear

timid cedar Dec 2, 2025, 1:17 PM

#

might it be worth not having the word "stable" in the tagline for experimental paper builds?

#

vocal halo Dec 2, 2025, 1:48 PM

#

experimental […]. proceed with caution

#

I don’t think paper provides support or guarantees it’s 100% stable so people can’t sue papermc for it.

humble perch Dec 5, 2025, 12:24 PM

#

can i ask questions in here if i have trouble wit paperMC plugins? >My core i use on my server is paperMC, where can i get help?

#

im new to this server

drowsy zinc Dec 5, 2025, 12:26 PM

#

this server is generally not the place for seeking help with plugin administration, you can try helpchat from #community-guilds

humble perch Dec 5, 2025, 12:26 PM

#

okay thank you sir!

opal flare Dec 5, 2025, 6:33 PM

#

<@&1190722804849582152> https://docs.papermc.io/misc/downloads-service/ needs updating, did not get updated after the pagination change to GraphQL endpoint. Also, the "lastest stable build" ones don't work if the most recent version has no STABLE channel downloads - those need adjusting

eager plover Dec 7, 2025, 8:25 AM

#

somebody borked docs deployment?

#

https://docs.papermc.io/paper/vanilla/#paper_global_spam_limiter_incoming_packet_threshold - is also incorrect, it's sorta like, how frequently you can send stuff, setting it that high just means that once you bust the limit you never recover

Vanilla-like experience | PaperMC Docs

This page lists all changes that result in a different experience than Vanilla.

pliant canopy Dec 7, 2025, 10:44 AM

#

eager plover somebody borked docs deployment?

Rip

#

A re-run of the action fixed it

random pollen Dec 8, 2025, 12:11 AM

#

outlines on this type of icon button or no

#

(the color is changed as part of a broader change where I'm reducing the blue-500 spam PepeLa )

vocal halo Dec 8, 2025, 12:21 AM

#

what did blue-500 do?

random pollen Dec 15, 2025, 3:03 AM

#

random pollen outlines on this type of icon button or no

#

(no outline won)

vocal halo Dec 15, 2025, 7:21 AM

#

Looks weird at first glance without the blue

opal flare Dec 15, 2025, 7:35 AM

#

the blue is too much imo

vocal halo Dec 15, 2025, 7:49 AM

#

Text was better readable with the blue imo

#

At least the selects

clever basalt Dec 15, 2025, 10:34 AM

#

i love the second version

#

if you use a color for everything then it's kinda noisy

brazen moon Dec 15, 2025, 1:27 PM

#

Looks like diff viewer can't read initial commit from github without parent

fair river Dec 15, 2025, 1:37 PM

#

@random pollen fix it Pout

random pollen Dec 15, 2025, 2:02 PM

#

brazen moon Looks like diff viewer can't read initial commit from github without parent

known, there’s a comment on the URL parsing function

#

might also be an issue idr

random pollen Dec 15, 2025, 6:31 PM

#

#

@slate scarab

slate scarab Dec 15, 2025, 7:42 PM

#

random pollen <@194473148161327104>

get out of my account

#

get out of my head

#

add file extension filters sir

timid mulch Dec 15, 2025, 8:47 PM

#

And a filter for moved files without content changes?

pliant canopy Dec 16, 2025, 9:56 AM

#

@violet bough sooo, regarding PaperMC/docs#697, which talks about the removal of the project setup using the MCDev plugin, I'd like to talk to you as a representative of MCDev.

To be frank with you, I fully agree. The default plugin template is really not that great. There are some unnecessary parts in the build script and generally also some straight up wrong stuff (I don't know if that is relevant anymore, but I remember that the default setup did not work the config cache; maybe that has changed since the last time I've used it, which has been ages frankly).

But I think this being the case is sad, as the plugin has other great uses as well, which are lesser known (like the event method generator, which I have seen nobody use). Instead, I wanted to directly ask you, whether you would accept a direct contribution to the template itself to modernise and fix it in order to keep that plugin as part of our Paper docs.

I realise I could've simply opened an issue on your repo, but I think having this in discussion openly like this could be nicer and more reachable.

vocal halo Dec 16, 2025, 10:39 AM

#

only real thing is that the templates aren't kotlin scripts, which kinda sucks a bunch
rage bait 😆

eager plover Dec 16, 2025, 10:40 AM

#

Not really rage bait, the community is moving away from groovy

vocal halo Dec 16, 2025, 10:50 AM

#

poor groovy.

violet bough Dec 16, 2025, 5:18 PM

#

pliant canopy <@172586171057176576> sooo, regarding [PaperMC/docs#697](<https://github.com/Pap...

we encourage people to PR improvements to the templates https://github.com/minecraft-dev/templates/

GitHub

GitHub - minecraft-dev/templates: The default templates for Minecra...

The default templates for MinecraftDev. Contribute to minecraft-dev/templates development by creating an account on GitHub.

pliant canopy Dec 16, 2025, 5:18 PM

#

Alright very well, I will shoot up a PR and you can tell me what you think of it

#

I think that's the nicer option to just completely nuke it off the docs site

violet bough Dec 16, 2025, 5:18 PM

#

Planning on getting rid of all the groovy build scripts too

pliant canopy Dec 16, 2025, 5:19 PM

#

Great, we should encourage people to use kts Gradle anyways

violet bough Dec 16, 2025, 5:19 PM

#

only use groovy since those templates were originally put together prior to when kotlin build scripts even existed

pliant canopy Dec 16, 2025, 5:19 PM

#

Fair enough

#

Never done any IJ templates, how do I test these?

#

Oh well, it is explained in the README, fair enough

violet bough Dec 16, 2025, 5:21 PM

#

unfortunately if you go to test this the local repo is currently broken because jetbrains did what jetbrains does

#

So, just give us some time to fix that

#

Unrelated but I am a bit taken aback by how you worded your original message, if I would "accept a direct contribution to the template" - mcdev has been an open source project since day 1, over 10 years ago. I've never been antagonistic towards accepting contributions, the way you presented the message feels as if you expected some kind of push back from me. I assume that isn't what you meant, but it was jarring for me to read that, confused by the tone I perceived

pliant canopy Dec 16, 2025, 5:26 PM

#

violet bough Unrelated but I am a bit taken aback by how you worded your original message, if...

Oh god, excuse me a lot for that; that was obviously not my intention 😅, please forgive me for the wording

violet bough Dec 16, 2025, 5:26 PM

#

it's all good, just a classic case of tone coming across wrong via text. It happens, and sorry I read it that way

pliant canopy Dec 16, 2025, 5:26 PM

#

I just wrote that on a whim, so maybe re-reading that could've been a good idea

vocal halo Dec 16, 2025, 5:30 PM

#

pliant canopy I think that's the nicer option to just completely nuke it off the docs site

I don’t understand why you want to do that like it is the worst part of the documentation.

pliant canopy Dec 16, 2025, 5:30 PM

#

vocal halo I don’t understand why you want to do that like it is the worst part of the docu...

That's what the issue requested, not what I want to do

#

ded

pliant canopy Dec 16, 2025, 5:39 PM

#

violet bough unfortunately if you go to test this the local repo is currently broken because ...

Right, that's fun

#

@drowsy zinc omg they finally closed it https://github.com/expressive-code/expressive-code/issues/342

GitHub

`<Code>` component styles missing when setting `emitExternalStylesh...

When setting emitExternalStylesheet: false in the astro-expressive-code integration, the <Code> component breaks, rendering without any styles. Expressive Code version astro-expressive-code: ...

vocal halo Dec 16, 2025, 5:47 PM

#

pliant canopy That's what the issue requested, not what I want to do

Oh sorry

#

I read it as we can do this and that

#

And not yeah this is a better alternative

#

Sorry

pliant canopy Dec 16, 2025, 5:48 PM

#

Yeah, I've been kinda wanting to improve the mcdev templates for a while now, I just kinda never got the push I needed

hearty briar Dec 16, 2025, 5:51 PM

#

vocal halo I don’t understand why you want to do that like it is the worst part of the docu...

even if the template is improved, I honestly think that part of the documentation is redundant to say the least

pliant canopy Dec 16, 2025, 5:51 PM

#

The clicking buttons part, perhaps

hearty briar Dec 16, 2025, 5:51 PM

#

a recommendation to use mcdev on the top as an alternative to manual setup would've been enough

pliant canopy Dec 16, 2025, 5:51 PM

#

But the mcdev template project setup step is fine I believe

#

Remember, this is for people who have never made a plugin before and might have very little Gradle knowledge

hearty briar Dec 16, 2025, 5:55 PM

#

I don't think that's productive given we will in fact just send people to learn java if they don't know how to follow that guide

pliant canopy Dec 16, 2025, 5:55 PM

#

Knowing Java is a different topic from knowing Gradle

hearty briar Dec 16, 2025, 5:55 PM

#

but well, it is already part of the documentation so there's no harm in just leaving it there at this point, I am not that against it

pliant canopy Dec 16, 2025, 5:56 PM

#

You can know Java without having tooling knowledge

hearty briar Dec 16, 2025, 5:56 PM

#

I would disagree, you need to be able to understand the tooling at least on a basic level in order to understand java on a basic level

pliant canopy Dec 16, 2025, 5:56 PM

#

Or you might come from a different background, like C#, meaning you are not entirely lost when doing Java dev, but might still not have any Gradle knowledge

hearty briar Dec 16, 2025, 5:57 PM

#

like, I don't need to understand Gradle to just add compileOnly("...") to my build script

pliant canopy Dec 16, 2025, 5:57 PM

#

hearty briar I would disagree, you need to be able to understand the tooling at least on a ba...

That's very wrong. IntelliJ default project creation is their own system which does not concern itself with neither Gradle nor Maven

pliant canopy Dec 16, 2025, 5:58 PM

#

hearty briar like, I don't need to understand Gradle to just add `compileOnly("...")` to my b...

The template does other stuff as well, like set the toolchain java version or add a processResources task for plugin yml templating

hearty briar Dec 16, 2025, 5:58 PM

#

that is not necessary to get your plugin going, it is just a nice to have

pliant canopy Dec 16, 2025, 5:58 PM

#

I am also planning to include the run-paper plugin as a clickable button as that's kinda nice

#

So what? Are we not allowed to include nice to haves for people wanting to start plugin dev?

#

I don't see how having a QoL step will hurt anyone

hearty briar Dec 16, 2025, 5:58 PM

#

the point is that they have to understand that, and they don't

pliant canopy Dec 16, 2025, 5:59 PM

#

You just said it is easy to understand

#

ded

hearty briar Dec 16, 2025, 5:59 PM

#

???, I said they need to understand it on a basic level, at least to the point they can understand where to place the compileOnly

#

if they can't understand that, then they'll be severly lost when doing anything else

pliant canopy Dec 16, 2025, 6:00 PM

#

I am completely lost in what your point even is

#

What are you trying to prove

hearty briar Dec 16, 2025, 6:00 PM

#

hearty briar I don't think that's productive given we will in fact just send people to learn ...

.

pliant canopy Dec 16, 2025, 6:00 PM

#

Again, Gradle != Java

hearty briar Dec 16, 2025, 6:00 PM

#

and again, it doesn't matter

vocal halo Dec 16, 2025, 6:01 PM

#

hearty briar I would disagree, you need to be able to understand the tooling at least on a ba...

you dont

hearty briar Dec 16, 2025, 6:01 PM

#

they don't need to know how to make gradle plugins to understand how to add a dependency to the dependencies block

vocal halo Dec 16, 2025, 6:01 PM

#

99% of gradle features you dont need for basic plugins

pliant canopy Dec 16, 2025, 6:01 PM

#

Why exactly does it matter then? Again, is there anything actively bad about us recommending to use the mcdev wizard for project setup?

hearty briar Dec 16, 2025, 6:06 PM

#

Alright, I'll be abundantly clear so as to not cause more confusion. As mentioned above, I don't think it is bad to recommend the mcdev plugin, the plugin itself is fine regardless of the templates being "outdated", but I think it is redundant if not counter-productive to the people reading the project setup documentation to tell them how to setup the project manually, then go on to tell them how to do the same thing but with an IntelliJ addon. If they understand how to install the plugin, I don't believe they need help to know how to use the wizard, and if they do that'd be up to MCDev's documentation and not Paper's. The only reason I see it as counter productive is because people often follow guides on a step-by-step basis, and I've helped people who have followed that guide setup a project twice just because the project setup guide explains how to do the same thing twice

#

the recommendation to the plugin could just be a note on the top of that guide, but the way it is now feels redundant if not hard to understand

vocal halo Dec 16, 2025, 6:08 PM

#

i dont see it

hearty briar Dec 16, 2025, 6:08 PM

#

well, you don't have to agree with me, that's just the way I see it

vocal halo Dec 16, 2025, 6:09 PM

#

if it says

Alternatively, you can...
how is that confusing or hard to understand?

#

And if people cant read docs that not papers fault

neon atlas Dec 16, 2025, 6:09 PM

#

I am semi certain most positions in this have been stated 😅

hearty briar Dec 16, 2025, 6:10 PM

#

I am not going to argue this point any more than I have, so yeah ^

spice temple Dec 17, 2025, 1:11 PM

#

I just wanted to complain about fill-ui looking awful but that was just dark reader, wtf

vocal halo Dec 17, 2025, 1:35 PM

#

I think it looks a bit weird. But I can’t tell why.

lean venture Dec 17, 2025, 2:29 PM

#

spice temple I just wanted to complain about fill-ui looking awful but that was just dark rea...

would be surprised if it sucked since it's just shadcn if I recall

pliant canopy Dec 17, 2025, 3:04 PM

#

violet bough So, just give us some time to fix that

By the way, could you ping me for when you've fixed it? No rush on that, I'd just like to know

brazen moon Dec 17, 2025, 3:56 PM

#

https://github.com/PaperMC/docs/issues/117 can probably be closed with data driven enchant now

random pollen Dec 17, 2025, 4:05 PM

#

if you want to see it look bad then check out the loading animations on iOS

#

https://github.com/PaperMC/fill-ui/issues/14

pliant canopy Dec 17, 2025, 4:09 PM

#

brazen moon https://github.com/PaperMC/docs/issues/117 can probably be closed with data driv...

I think that's fair; it is kinda documented in the registries page as well after all

random pollen Dec 20, 2025, 7:10 PM

#

https://github.com/PaperMC/diff-viewer/pull/58 filter: Modified kts files not in test-plugin

GitHub

Diff filtering by jpenilla · Pull Request #58 · PaperMC/diff-viewer

Still need to decide on a strategy for default/global filters in app settings (current is only per-session), as well as strategy for persisting filters within a session (i.e. url params vs history ...

#

~~not sure why it's showing the AT diff though omegaroll ~~fixed

steady fulcrum Dec 21, 2025, 9:41 PM

#

opal flare <@&1190722804849582152> <https://docs.papermc.io/misc/downloads-service/> needs ...

hi docs team here https://github.com/PaperMC/docs/pull/698 thank you :)

GitHub

chore: update download service docs by mja00 · Pull Request #698 ...

Get latest stable build script will now always retrieve the latest stable build.
GraphQL examples now use pagination.

scenic gull Dec 21, 2025, 9:44 PM

#

Related, the graphql playground's starting example doesn't work.

steady fulcrum Dec 21, 2025, 9:48 PM

#

I blame riley

#

Lemme figure out where that even exists lol

fair river Dec 21, 2025, 10:19 PM

#

CC: @pliant canopy as riley is currently busy. yes

pliant canopy Dec 21, 2025, 10:20 PM

#

hi idk graphql

#

lgtm

#

@steady fulcrum mergable?

steady fulcrum Dec 21, 2025, 10:21 PM

#

ya

pliant canopy Dec 21, 2025, 10:22 PM

#

Great, all I needed to hear

steady fulcrum Dec 21, 2025, 10:22 PM

#

it's just the new pagination stuff and a more robust shell script

#

pagination is just the standard graphql shiz

drowsy zinc Dec 21, 2025, 10:22 PM

#

is the sort needed

steady fulcrum Dec 21, 2025, 10:24 PM

#

yeah probably

#

no it's not

#

it was when I was doing query dumbly

drowsy zinc Dec 21, 2025, 10:30 PM

#

very cringe

#

org banned

#

❤️

steady fulcrum Dec 21, 2025, 10:31 PM

#

you can thank gemini 3 for that

neon epoch Dec 21, 2025, 10:49 PM

#

Thought we were being replaced

#

I guess Scorps job is safe

drowsy zinc Dec 22, 2025, 11:36 AM

#

oops accidentally pushed a local branch

pliant canopy Dec 22, 2025, 11:41 AM

#

lol

steady fulcrum Dec 22, 2025, 1:28 PM

#

smh scorp

subtle cloak Dec 26, 2025, 4:52 AM

#

Hello

ocean void Dec 26, 2025, 4:54 AM

#

subtle cloak Hello

Uh hi? If you're looking for a general chat/conversation channel it's here: #general

subtle cloak Dec 26, 2025, 4:58 AM

#

I need paper file 1.20.4

outer elkBOT Dec 26, 2025, 5:01 AM

#

river geyser Dec 28, 2025, 4:22 AM

#

is there reason downloading the .bat n running it in a file w server.jar it says 'java is not a internal or external command'

#

(on windows 11)

#

it worked on windows 10

scenic gull Dec 28, 2025, 4:23 AM

#

This is the channel for discussing our documentation and website. Follow these directions and if you need more help, visit #paper-help

outer elkBOT Dec 28, 2025, 4:23 AM

#

river geyser Dec 28, 2025, 4:24 AM

#

oh am I an idiot and forgot to install java on new pc 🤦‍♂️

spice temple Dec 29, 2025, 3:50 PM

#

if somebody is bored, I think we need better error handling in javaducks, like making sure errors dont get cached and maybe check that all filesystem things are handled correctly https://github.com/seiama/javaducks/issues/30

hard quartz Dec 29, 2025, 4:02 PM

#

the cache is not a cloudflare thing?

spice temple Dec 29, 2025, 4:04 PM

#

thats ontop

sharp pivot Dec 29, 2025, 10:11 PM

#

brazen moon Jan 2, 2026, 8:20 PM

#

that restart command was more a spigot command (might need a new section) but looking at it there's several missing command permissions here such as:
/spigot reload (spigot)
/mspt (paper)
/tps (spigot)

#

also not sure why https://docs.papermc.io/paper/reference/permissions/#paper-permissions include command permissions that are not in the first section

pliant canopy Jan 5, 2026, 7:33 PM

#

Docs channel got demoted below build-tooling-help :(
-# (I noticed earlier, but only now thought of something funny to write)

fair river Jan 5, 2026, 7:39 PM

#

I actually don’t know if it’s intentional

#

Or some core team just fat fingered

pliant canopy Jan 5, 2026, 7:47 PM

#

@ cat stop fat fingering

#

It certainly messed up my workflow

#

This caused my plugin to not compile

#

Because it depends on the position of the docs-website channel in my channel list for sha generation

ocean void Jan 5, 2026, 8:12 PM

#

I mean build-tooling-help is probably more active / needs more prominence for help topics.

#

But yeah I'm guessing it was an accident.

fallow hedge Jan 5, 2026, 8:41 PM

#

another famous cat drag and drop

pliant canopy Jan 5, 2026, 8:42 PM

#

fallow hedge another famous cat drag and drop

It's always the brits

fallow hedge Jan 5, 2026, 8:42 PM

#

or mbax and his “occasional hand tremor thing” PES3_Sus

scenic gull Jan 5, 2026, 9:44 PM

#

pliant canopy Docs channel got demoted below build-tooling-help :( -# (I noticed earlier, but...

build tooling ended up entirely out of this section earlier so I put it back where I thought it went.

scenic gull Jan 5, 2026, 9:44 PM

#

fallow hedge or mbax and his “occasional hand tremor thing” <:PES3_Sus:523048411075969026>

It's real and sucks, thanks. ❤️

pliant canopy Jan 5, 2026, 9:45 PM

#

scenic gull build tooling ended up entirely out of this section earlier so I put it back whe...

fallow hedge Jan 5, 2026, 9:45 PM

#

scenic gull It's real and sucks, thanks. ❤️

uh huh yeah man I believe you!

#

peepoheart

last bear Jan 12, 2026, 11:27 AM

#

plugin messaging could use a section on how those custom payloads work outside of bungee stuff

#

that a modded client or whatever puts what it wants to receive into a minecraft:register custom payload, and only then can you send on that channel via player.sendPluginMessage

nimble marlin Jan 12, 2026, 10:42 PM

#

any idea what this is? https://github.com/PaperMC/docs/actions/runs/20937495228/job/60163537735?pr=714#step:6:64 didn't get the error locally when i built the docs

drowsy zinc Jan 12, 2026, 10:50 PM

#

it's been happening on and off on the ci for a while and I haven't gotten to looking into it

#

I re-ran the job and it should be fine I think

opal flare Jan 12, 2026, 10:51 PM

#

I blame @scenic gull

#

he infected github actions with kittens

#

and they are eating the pages

#

what do you have to say for yourself @scenic gull!

scenic gull Jan 12, 2026, 10:56 PM

#

._.

nimble marlin Jan 12, 2026, 10:56 PM

#

can you infect my house with kittens instead?

scenic gull Jan 12, 2026, 10:58 PM

#

nimble marlin Jan 12, 2026, 11:00 PM

#

:(

pliant canopy Jan 12, 2026, 11:00 PM

#

I blame scorp

#

No other possibility

#

He's the astro guy

#

The frontend dev of us

#

The typescript enjoyer

drowsy zinc Jan 13, 2026, 12:52 PM

#

5 ignored messages

jagged pecan Jan 14, 2026, 7:28 AM

#

nimble marlin any idea what this is? <https://github.com/PaperMC/docs/actions/runs/20937495228...

I diagnose it with failed build

drowsy zinc Jan 19, 2026, 12:48 PM

#

@sharp pivot https://github.com/PaperMC/docs/pull/709

GitHub

fix(velocity): explicitly add the annotation processor in Maven by ...

Apparently with JDK 23 the main classpath is no longer scanned, so it wouldn't find the annotation processor.

sharp pivot Jan 19, 2026, 12:49 PM

#

my bad, didn't think anyone else ran into it yet

drowsy zinc Jan 19, 2026, 12:50 PM

#

I could merge it if you think it's good

#

I don't know maven so I left it for comments

sharp pivot Jan 19, 2026, 12:52 PM

#

already approved but, maybe having separate tabs for maven 3 and 4 would be good

#

i could see someone not reading and copying the whole thing into their pom.xml

drowsy zinc Jan 19, 2026, 12:54 PM

#

will do

lapis gust Jan 23, 2026, 8:05 AM

#

dont be stupid like this guy

mental sleetBOT Jan 23, 2026, 8:05 AM

#

sacred musk Jan 24, 2026, 5:08 PM

#

scenic gull

8

scenic gull Jan 24, 2026, 5:14 PM

#

sacred musk 8

Do you have a comment about our docs/website?

sacred musk Jan 24, 2026, 5:14 PM

#

It was an accident i think

pliant trail Jan 25, 2026, 7:49 AM

#

hello

vocal halo Jan 26, 2026, 12:50 PM

#

https://github.com/PaperMC/docs/pull/720/ should we also mention velocity 3.5.0 requiring 21?

GitHub

fix(paper/admin): change recommendation for Java version by Doc94 ...

This PR fix a few JDK Recommendation for Minecraft Releases

hard quartz Jan 26, 2026, 1:55 PM

#

vocal halo https://github.com/PaperMC/docs/pull/720/ should we also mention velocity 3.5.0 ...

this?
https://docs.papermc.io/velocity/getting-started/#installing-java

Getting started | PaperMC Docs

How to install and set up a minimal configuration of Velocity.

vocal halo Jan 26, 2026, 2:22 PM

#

Yes

hard quartz Jan 26, 2026, 2:25 PM

#

that can be another PR if wanna rephrase that

limpid oriole Jan 27, 2026, 3:18 PM

#

How do you change the version of the Minecraft server? I wanted to set it to 1.21.1

twilit fog Jan 27, 2026, 3:20 PM

#

limpid oriole How do you change the version of the Minecraft server? I wanted to set it to 1.2...

#paper-help

limpid oriole Jan 27, 2026, 3:21 PM

#

thanks friend

vocal halo Jan 27, 2026, 4:40 PM

#

i just tried to access adventure JD and as usual went to jd.papermc.io but couldnt find it there. Did you already discuss/think about adding it? Is there any reason to not add it, now that is is part of papermc?

drowsy zinc Jan 27, 2026, 5:17 PM

#

it's probably on the bottom of someone's todo list, given the various random changes that would be necessary post-migration and the fact that it works fine

eager plover Jan 27, 2026, 5:18 PM

#

adventures JDs are a lot more split out vs the primary platforms we have, I think it's sorta on the todo list but not a high priority and we'd need to figure out how to deal with 20 dozen artifacts

timid cedar Jan 27, 2026, 5:18 PM

#

we could just add a button that links to jd.advntr.dev

vocal halo Jan 27, 2026, 5:55 PM

#

that's what i meant ^^

hard quartz Jan 27, 2026, 6:14 PM

#

vocal halo that's what i meant ^^

you can suggest in the website repo for consider that

vocal halo Jan 27, 2026, 6:55 PM

#

i decided to ask here first to find out if this has already been discussed. I didn't want to open an unnecessary issue

supple burrow Feb 2, 2026, 9:37 PM

#

dude Strokkur24 was just acting like an ass wipe in my pr rn to me

#

bro didn't even bother to check

#

closed it and thats it

neon atlas Feb 2, 2026, 9:39 PM

#

strokk is sometimes stupid

#

and cannot read two lines above

#

where LiteCommands is also in that table

supple burrow Feb 2, 2026, 9:39 PM

#

yep

#

bro should at least bother to ask

#

if too lazy to check

#

am i supposed to open it again?

neon atlas Feb 2, 2026, 9:44 PM

#

Yea please do 👍

supple burrow Feb 2, 2026, 9:44 PM

#

oh i have to make it again

#

i can't reopen

sharp pivot Feb 2, 2026, 9:45 PM

#

pressed the button for you

supple burrow Feb 2, 2026, 9:46 PM

#

🙏

#

is there ANYBODY other than Strokk that reviews docs? 😭

pliant canopy Feb 2, 2026, 9:56 PM

#

Look, I made a mistake, no need to be personal about it

supple burrow Feb 2, 2026, 9:56 PM

#

thats not it

pliant canopy Feb 2, 2026, 9:56 PM

#

I didn't notice the exact section you PRed it to

supple burrow Feb 2, 2026, 9:56 PM

#

i sent this on 2 lines

#

he said you cant read 2 lines

#

ok jokes are done now

#

🤝

#

im sorry for calling you an asswipe tho, you seem cool

#

today was not my best day is all

#

mb

pliant canopy Feb 2, 2026, 10:00 PM

#

Yeah, it apparently wasn't my best day either

#

Glad we got it figured out, and sorry for closing your PR

supple burrow Feb 2, 2026, 10:00 PM

#

its okay, it happens ig

#

it it normal for checks to be cancelled?

pliant canopy Feb 2, 2026, 10:09 PM

#

GitHub actions seems to be down

#

The main branch is also not having any luck atm

supple burrow Feb 2, 2026, 10:09 PM

#

@_@

vocal halo Feb 4, 2026, 7:54 AM

#

For transparency you should really provide a reason why you don’t accept their PR

#

Since there seems to be another command framework present there as well

ocean void Feb 4, 2026, 7:56 AM

#

vocal halo For transparency you should really provide a reason why you don’t accept their P...

(This user is no longer in this discord.)

vocal halo Feb 4, 2026, 8:14 AM

#

I know, but I would like to know why

#

It seems pretty unfair

opal flare Feb 4, 2026, 9:05 AM

#

vocal halo I know, but I would like to know why

Transphobia/homophobia, bigotry, and ban evasion. The user was originally banned over at Kyori back in 2024, but during the organization move they became unbanned.

vocal halo Feb 4, 2026, 9:09 AM

#

Okay I see thanks for clarification

mighty dirge Feb 4, 2026, 8:21 PM

#

The lifecycle example seems a bit confusing to me because it doesn't show that you need to register the handler in the lifecycle manager or not?
-# https://docs.papermc.io/paper/dev/lifecycle/#lifecycleevents

pliant canopy Feb 4, 2026, 8:22 PM

#

It's in the https://docs.papermc.io/paper/dev/lifecycle/#registering thing afterwards, but I agree with you, it's a bit confusing

#

I think that page could use some general love with an example or two anyways

mighty dirge Feb 4, 2026, 8:25 PM

#

pliant canopy It's in the <https://docs.papermc.io/paper/dev/lifecycle/#registering> thing aft...

ah yea thanks, that's what I get for reading the full page :)

brazen moon Feb 4, 2026, 9:19 PM

#

that's kinda what the registries and datapack discovery page are for but not sure if they are linked?

pliant canopy Feb 4, 2026, 9:32 PM

#

They aren't really linked directly

#

I think it needs a cleanup anyways

#

Also need to add in the tag flattening things

scenic gull Feb 8, 2026, 5:22 PM

#

Just popping in to note --add-plugin-dir seems missing from live docs 🙂

neon atlas Feb 8, 2026, 7:11 PM

#

I don't think we have any docs on the jar args actually?

fair river Feb 8, 2026, 7:16 PM

#

neon atlas I don't think we have any docs on the jar args actually?

slavewhip https://docs.papermc.io/paper/reference/system-properties/

System properties | PaperMC Docs

Documentation for the system properties and environment variables Paper may check.

neon atlas Feb 8, 2026, 7:16 PM

#

That's system properties

brazen moon Feb 8, 2026, 7:40 PM

#

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

whole oar Feb 9, 2026, 10:33 PM

#

my docs where is code

south thunder Feb 9, 2026, 10:33 PM

#

?

whole oar Feb 9, 2026, 10:34 PM

#

south thunder ?

https://hangar.papermc.io/

Hangar

Hangar - The best place to download Minecraft plugins

Hangar allows you to find and download the best Minecraft plugins for your Minecraft server

#

??

south thunder Feb 9, 2026, 10:36 PM

#

You want #hangar-help instead, you should write your plugin description in Markdown

mighty dirge Feb 10, 2026, 1:54 PM

#

Maybe note in the Velocity docs that the annotation processor only works for java and for kotlin you have to manually use the velocity-plugin.json or kapt

eager plover Feb 10, 2026, 3:34 PM

#

falls into that "and what about scala?" territory; Annoyingly, for as niche as kotlin is in this community, it seems to pop up a lot, especially with fairly common traps and kotlins documentation last I rember wasn't the most amazing here

timid cedar Feb 10, 2026, 3:36 PM

#

kotlin is not that niche considering how often i see people ask about kapt

#

not even in the same ocean as scala for plugins haha

eager plover Feb 10, 2026, 3:37 PM

#

niche was maybe a bit harsh; it's used but I rarely see it here; we have 152 results for kapt

random pollen Feb 10, 2026, 5:16 PM

#

I still don't understand why anyone would use the AP, it's more complicated and annoying to setup than just generating the file especially if you want to substitute any values from your build script

#

I'm partial to https://github.com/jpenilla/resource-factory but even just good old processResources and a json file seems more convenient than the AP to me

mighty dirge Feb 10, 2026, 5:20 PM

#

yea I think we should prefer the ap in the docs if not deprecate it

random pollen Feb 10, 2026, 5:22 PM

#

once someone does get the AP working, their next thought will be "ok now how do I insert the version number from my project" and with the AP the answer is you need to use source code templating or preprocessing

#

which is super over the top

eager plover Feb 10, 2026, 5:22 PM

#

I mean, the AP does feel kinda cludgy, like it's often come up especially with stuff like maven no longer scanning for them anymore

nimble marlin Feb 10, 2026, 5:23 PM

#

(also kapt sucks, if people actually want to care about the AP I had a PR adding KSP support a while back)

eager plover Feb 10, 2026, 5:23 PM

#

honestly, it's more in a area where the json file is basically undocumented and the AP is the only documented way to do it

nimble marlin Feb 10, 2026, 5:24 PM

#

probably better to document the json file at this point tbh

eager plover Feb 10, 2026, 5:24 PM

#

Yea

random pollen Feb 10, 2026, 5:24 PM

#

yeah I had to open the velocity src to figure it out when I implemented resource factory

timid cedar Feb 10, 2026, 5:24 PM

#

i agree with documenting the json file

pliant canopy Feb 10, 2026, 6:50 PM

#

That sounds sane

#

Perhaps we should also update... uh... the mcdev templates

#

@violet bough god damnit

#

kekw

#

I had a stroke writing the description for it, but here we go https://github.com/PaperMC/docs/issues/731

#

Either someone gets to it relatively soon-ish, or I will fix it whenever I have my next docs writing spree and go through some of the issues

violet bough Feb 10, 2026, 7:20 PM

#

pliant canopy <@172586171057176576> god damnit

fill me in on context I ain't readin up

pliant canopy Feb 10, 2026, 7:52 PM

#

violet bough fill me in on context I ain't readin up

The Velocity @Plugin annotation, which combined with the Velocity annotation processor used to generate the plugin sjon file (basically a bukkit plugin.yml, but it's a json file) should no longer be the main recommended way in the docs, and for that reason the mcdev template needs updating to instead generate a json file which should be edited manually. Basically this issue: minecraft-dev/templates#46

pliant canopy Feb 11, 2026, 7:46 PM

#

@drowsy zinc opinion on removing the status: accepted label, as I don't have a feeling it does anything?

twilit fog Feb 11, 2026, 10:36 PM

#

pliant canopy <@504916819987922954> opinion on removing the `status: accepted` label, as I don...

isn't that for issues (feature requests)?

#

don't know if my opinion matters, but if you want to make a PR for an issue it's surely better to see maintainers agree with it

hearty briar Feb 12, 2026, 2:07 AM

#

if a maintainer disagrees with whatever the issue poses then it'd just be closed, feels redundant

twilit fog Feb 12, 2026, 7:04 AM

#

hearty briar if a maintainer disagrees with whatever the issue poses then it'd just be closed...

Perhaps, but then again what if an issue has been open for a while and hasnt received any comments from maintainers? Best you can do is assume the maintainers are okay with it, whereas a label makes it clear

nimble marlin Feb 12, 2026, 7:04 AM

#

you can...ask?

#

which is generally encouraged if you want to pr something

pliant canopy Feb 12, 2026, 7:22 AM

#

Currently, all issues which are open would be accepted, at least to some extend. And if an issue is labelled in general, you can already treat it as accepted, as that is a sort of maintainer comment itself

#

I guess the one issue not accepted how it was posted was that mcdev plugin removal issue, but that was dealt with already (including a discussion in the comments)

#

And as abby said, if you are unsure, it takes about 10 seconds to open this channel, link the issue, and ask if you may open a PR for it

twilit fog Feb 12, 2026, 8:06 AM

#

fair enough

mighty dirge Feb 13, 2026, 11:18 AM

#

Could it be nice to have a feedback post in #1120783097802276906 for the Pre-Player-Obj-Perms API?
-# And close the old/completed ones

trail jasper Feb 17, 2026, 4:02 PM

#

<@&748618676189528155>

mental sleetBOT Feb 17, 2026, 4:02 PM

#

hard quartz Feb 23, 2026, 2:00 PM

#

Maybe can be consider a redirect or something for old javadoc urls like https://papermc.io/javadocs/paper/1.18/org/bukkit/entity/ThrowableProjectile.html ?
Currently just go to the default 404 page (still in queue a PR for modify that 404 page)

eager plover Feb 23, 2026, 2:04 PM

#

part of the reason for moving stuff to the new URLs is because adding redirects in the new infra is a bit of a headache, especially if you're wanting them to be smart

#

I guess maybe with our cloudflare plan we can get away with it now

slate arrow Feb 23, 2026, 2:13 PM

#

i believe this section needs to be corrected as its no longer true after the hardfork
https://docs.papermc.io/paper/migration/#from-craftbukkit-or-spigot

Paper retains full compatibility with all Spigot plugins, allowing a seamless transition.

scenic gull Feb 23, 2026, 2:42 PM

#

Yes, probably a good idea. Open an issue!

pliant canopy Feb 23, 2026, 3:02 PM

#

Does this work in terms of rephrase (cc @scenic gull)

Up until 1.20.5, Paper retained full compatibility with all Spigot plugins. However, Spigot plugins made after that version may not fully work. Such plugins may often provide Paper-compatible builds. If they do not do that, you may need to look for an alternative.

spice temple Feb 23, 2026, 3:08 PM

#

I would be more specific, as in, spigot plugins that use spigot api released after 1.20.5 will not work on paper

#

but additionally something like most plugins are written for paper? idk

pliant canopy Feb 23, 2026, 3:12 PM

#

Up until 1.20.5, Paper retained full compatibility with all Spigot plugins. However, plugins using Spigot API added after 1.20.5 version will not work. Such plugins may often provide Paper-compatible builds. If they do not do that, you will need to look for alternatives.

twilit fog Feb 23, 2026, 3:37 PM

#

Look for*

scenic gull Feb 23, 2026, 3:46 PM

#

Probably a final remark that most plugins are built and tested against paper these days?

pliant canopy Feb 23, 2026, 3:54 PM

#

Up until 1.20.5, Paper retained full compatibility with all Spigot plugins. However, plugins using Spigot API added after 1.20.5 version will not work. Such plugins may often provide Paper-compatible builds. If they do not do that, you will need to look for alternatives. However, nowadays most plugins are built and tested against Paper, so you typically will not encounter incompatible plugins.

#

Now it's lengthy

spice temple Feb 23, 2026, 3:55 PM

#

people dont need to read it, its like a side note

pliant canopy Feb 23, 2026, 4:10 PM

#

Please don't need to read it
Docs

#

sadge

scenic gull Feb 23, 2026, 4:12 PM

#

Docs are for the second pass at learning 😂

vocal halo Feb 23, 2026, 6:49 PM

#

maybe "many" and not "most"? or do we know that?

#

nvm just saw the commit

spice temple Feb 23, 2026, 6:51 PM

#

pliant canopy >Please don't need to read it >Docs

Not docs in general, just that disclaimer, lol

#

I see it as a, hey, we told you to double check! When somebody complains about some plugin by some of the backwards thinking people that go out of their way to break paper compat

#

But since the fast majority of servers run paper derivstes, not spigot, any self respecting plugin dev tests on paper

pliant canopy Feb 23, 2026, 6:56 PM

#

I mean yeah, if it took this long to even notice, this probably isn't too often looked at anyways

spice temple Feb 23, 2026, 6:59 PM

#

Well, or it does it's job of not discouraging paper usage ^^

fair river Feb 23, 2026, 8:00 PM

#

I think the paragraph should start by saying most modern and up-to-date plugins all already depend on Paper. I agree with mini that we should probsbly not even go into too much details about Spig*t

lusty nova Feb 23, 2026, 8:07 PM

#

spice temple Well, or it does it's job of not discouraging paper usage ^^

its*

brazen moon Feb 26, 2026, 6:03 PM

#

https://docs.papermc.io/paper/dev/command-api/arguments/registry/#registry-key-previews
this is outdated strokkur, zombie nautilus variant, gamerule etc are not included

Registry | PaperMC Docs

Documentation for arguments retrieving registry values.

pliant canopy Feb 26, 2026, 6:09 PM

#

sadge

#

Will look at it sometime

brazen moon Mar 5, 2026, 5:33 PM

#

take your time but tbh this page feels clunky I think people would get the gist with a single example.

#

also I want to expose the tag argument at some point so that would duplicate everything

pliant canopy Mar 5, 2026, 5:34 PM

#

Yeahh, it was fine when I initially wrote the docs, but I forgot that it'd need pretty constant maintanance

#

I will probably indeed simplify it to just one single example and simply list them in a table

#

Will do that on my 26.1 update branch, where I will update them to the registry entries exposed in 26.1 as well (idk if 26.1 adds anything, but might as well)

brazen moon Mar 5, 2026, 5:36 PM

#

bunch of new sound variant registries iirc

pliant canopy Mar 5, 2026, 5:36 PM

#

Does that add new registries though?

brazen moon Mar 5, 2026, 5:36 PM

#

well like wolf currently

vocal halo Mar 5, 2026, 6:39 PM

#

brazen moon take your time but tbh this page feels clunky I think people would get the gist ...

i also think that the page is a bit too verbose

pliant canopy Mar 6, 2026, 2:09 PM

#

What's the stance on having some very basic NMS description page, which gives a rough overview of, for example, bukkit <-> nms object conversion (cast+handle), maybe some help on how packets generally work, perhaps with reference to the multiversion paperweight example plugin, and just generally a guide what to watch out for? I know the whole NMS trickery is super unsupported and docs don't exist as concrete implementations are prone to breaking quickly, but some of the more stable internal things I believe could be useful; also in view of, for example, data components not representable in API or reusing internal logic not exposed

neon atlas Mar 6, 2026, 3:19 PM

#

Not much of a fan on my end

trail jasper Mar 6, 2026, 3:45 PM

#

pliant canopy What's the stance on having some very basic NMS description page, which gives a ...

i never touch the docs for anything apart the configs anyway let alone do i contribute there so my opinion is probably not worth much
i think people who would profit from such docs the most are those who dont even know the api itself well enough to even consider diving down the internals rabbit hole – which means either they dont read much code and are in some kind of tutorial hell or they just started working with paper/minecraft and shouldnt touch nms until they actually know the code/api a bit
for the people who have a valid use case for using nms that probably would add much value since they most certainly already know how to work with it and how to accomplish certain things with nms

#

holy macaroni
sorry for the wall of text, didnt realize my two cents are that long

pliant canopy Mar 6, 2026, 3:46 PM

#

trail jasper holy macaroni sorry for the wall of text, didnt realize my two cents are that lo...

You should join the docs team, you seem to be quite capable of writing giggle /s

trail jasper Mar 6, 2026, 3:48 PM

#

i just have a lot of opinions on a lot of stuff
i cant even keep up documenting my own sht 😄

#

also you already covered everything anyone could ever dream of
so no idea what i would even document

mighty dirge Mar 6, 2026, 3:51 PM

#

yea, thank you Strokkur

pliant canopy Mar 6, 2026, 4:29 PM

#

trail jasper also you already covered everything anyone could ever dream of so no idea what ...

There are so many things undocumented, I find it impressive

#

Just check the issues tab, surely you would find something

#

Mahiru

scenic gull Mar 6, 2026, 9:31 PM

#

I think anyone capable of working with NMS can, trivially, identify the things you're proposing documenting. If they cannot, they are not ready to poke the bear.

serene vault Mar 7, 2026, 2:14 AM

#

pliant canopy What's the stance on having some very basic NMS description page, which gives a ...

I generally like this idea, but I don't think it should be part of the Paper docs or anything making it seem official/supported like that

fair river Mar 7, 2026, 2:31 AM

#

It's time for Strokkur.dev blog

dreamy radish Mar 7, 2026, 3:10 PM

#

add the kotlin version of the examples

pliant canopy Mar 7, 2026, 3:12 PM

#

Paper does not use Kotlin anywhere in the codebase, and the API is also written purely for Java. Kotlin is not a directly supported language, so we probably won't add Kotlin examples anytime soon

dreamy radish Mar 7, 2026, 4:20 PM

#

at least i tried

timid cedar Mar 7, 2026, 7:30 PM

#

also not necessary bc you can just paste java code into IDEA and it'll auto convert it to kotlin code

supple comet Mar 18, 2026, 10:22 PM

#

<@&748618676189528155>

drowsy zinc Mar 24, 2026, 6:47 PM

#

going to pull the trigger on the dependency updates, if anything breaks I blame it on the lack of reviews 😛

pliant canopy Mar 24, 2026, 7:06 PM

#

drowsy zinc going to pull the trigger on the dependency updates, if anything breaks I blame ...

You are a better front-end dev than me, so just view my lack of review as the trust I place in your hands

#

MahiruPray

hoary oriole Mar 24, 2026, 7:54 PM

#

when will they update for 26.1

outer elkBOT Mar 24, 2026, 7:54 PM

#

twilit fog Mar 24, 2026, 9:40 PM

#

as I expected it fails to build if the version header is set to 26.1 since it expects it to start with 1

hard quartz Mar 24, 2026, 9:43 PM

#

twilit fog as I expected it fails to build if the version header is set to 26.1 since it ex...

What fails?

twilit fog Mar 24, 2026, 9:45 PM

#

omg I think I know what is going on, it parses it as a float

#

26.1

#

what in the YAML like bullshit is this

#

[InvalidContentEntryDataError] docs → paper/dev/particles data does not match collection schema.

  **: [
  {
    "expected": "string",
    "code": "invalid_type",
    "path": [
      "version"
    ],
    "message": "version: Expected type `\"string\"`, received `\"number\"`"
  }
]

#

ye error message seems to confirm that

drowsy zinc Mar 24, 2026, 9:46 PM

#

the frontmatter is yaml yes

#

you have to put it in quotes

twilit fog Mar 24, 2026, 9:46 PM

#

version: "26.1"
I guess this'll have to do

#

ye

#

YAML strikes again

timid cedar Mar 26, 2026, 4:00 PM

#

@pliant canopy what did i break https://github.com/PaperMC/docs/actions/runs/23604296141/job/68742642527

#

it all looks fine to me

#

is the branch just out of date or smth?

#

yes it might be

pliant canopy Mar 26, 2026, 4:09 PM

#

timid cedar is the branch just out of date or smth?

Funnily enough, no, it just likes to do that sometimes

#

Re-running the job (which happened with your update) typically fixes it

timid cedar Mar 26, 2026, 4:13 PM

#

fab

#

okay the pr is all good to go! everything is up to date and all good and happy

pliant canopy Mar 26, 2026, 4:36 PM

#

@timid cedar wouldn't you perhaps also want to include the MiniMessage presets in there?

#

Could be a great chance to do so

timid cedar Mar 26, 2026, 4:36 PM

#

yeah good shout

timid cedar Mar 26, 2026, 5:55 PM

#

pliant canopy <@315570196549074945> wouldn't you perhaps also want to include the MiniMessage ...

done!

#

@pliant canopy was just thinking the docs update to 5.0.0 but that isn't released yet

#

do you wanna maybe hold off for now or should we update them to 5.0.0-SNAPSHOT or smth

pliant canopy Mar 26, 2026, 6:08 PM

#

I'd just merge it once the first Adventure 5.0 release goes online

timid cedar Mar 26, 2026, 6:08 PM

#

fab

drowsy zinc Mar 26, 2026, 6:50 PM

#

pliant canopy Funnily enough, no, it just likes to do that sometimes

that was indeed because the branch was out of date fwiw

pliant canopy Mar 26, 2026, 6:52 PM

#

drowsy zinc that was indeed because the branch was out of date fwiw

Okay cool, fuck me then

#

Everything I say is wrong

#

The universe is an egg

#

sadge

drowsy zinc Mar 26, 2026, 6:54 PM

#

the d2 plugin uses d2 in wasm pulled in by a normal npm dependency now so the d2 binaries are no longer installed in the workflow

pliant canopy Mar 26, 2026, 6:54 PM

#

Ah, did you do that with your dependency up PR?

drowsy zinc Mar 26, 2026, 6:54 PM

#

yes

pliant canopy Mar 26, 2026, 6:55 PM

#

Well, that's great

last solar Mar 28, 2026, 9:19 PM

#

Theoretically I'm a Contributor cause I PRed and got merged

lilac edge Mar 28, 2026, 10:16 PM

#

it's that easy thinksmart

vocal halo Mar 28, 2026, 11:38 PM

#

Yup

#

But it’s on a case by case basis to get contributor role. I also contributed a few PRs and didn’t get the role 🤷🏼‍♂️

pliant canopy Mar 28, 2026, 11:39 PM

#

I also never got the role, even after multiple Paper PRs

hearty briar Mar 28, 2026, 11:39 PM

#

isn't that one just added for people who aren't in the team to speak in #paper-contrib

pliant canopy Mar 28, 2026, 11:39 PM

#

Contributor role is for someone who has continuously contributed for a while now

pliant canopy Mar 28, 2026, 11:39 PM

#

hearty briar isn't that one just added for people who aren't in the team to speak in <#925530...

No, that's the paper-contrib role. Contributor also gives access to a few internal channels

hearty briar Mar 28, 2026, 11:39 PM

#

I see

smoky granite Mar 29, 2026, 12:04 AM

#

I never got contributor role either >:(

pliant canopy Mar 29, 2026, 12:05 AM

#

smoky granite I never got contributor role either >:(

This guy is playing two truths and a lie

#

And he is not that great at it

pliant canopy Apr 2, 2026, 8:49 PM

#

God our build times are abysmal

#

Almost all of that is just image preprocessing

#

Anyways, @mighty dirge, if you have time, I'd greatly appreciate if you'd check over #735 again. I did some changes based on your comment

#

If you sign off on it, I'd prolly merge it soon

mighty dirge Apr 2, 2026, 9:04 PM

#

pliant canopy Anyways, <@602488872542273567>, if you have time, I'd greatly appreciate if you'...

-# np, I'll do it tomorrow though

pliant canopy Apr 3, 2026, 4:05 PM

#

I think it's fine as-is now. The duplicate entries across the MC dev plugin and the velocity plugin json reference is not really a problem imo. Also that MCdev creator thing will be outdated anyways once my Velocity template PR goes through, so that's something to fix for then I guess

#

@drowsy zinc if you'd like to give #735 one last look over, I'd appreciate it. Will merge it afterwards

#

scorp, do you think this looks fine or is that too much text?

twilit fog Apr 3, 2026, 5:30 PM

#

pliant canopy scorp, do you think this looks fine or is that too much text?

Have you considered using https://expressive-code.com/key-features/text-markers/#marking-individual-text-inside-lines ?

Expressive Code

Text & Line Markers

pliant canopy Apr 3, 2026, 5:32 PM

#

twilit fog Have you considered using https://expressive-code.com/key-features/text-markers/...

How would that help me though? The main thing I am adding here are inline comments, it's less about marking stuff

#

There's also ofc the alternative of just saying "the marked fields are required", idk which is better

twilit fog Apr 3, 2026, 6:02 PM

#

perhaps make both and see which looks better?

#

not really a fan of the current setup, but if it looks better than the second, why not

random pollen Apr 3, 2026, 7:29 PM

#

For whoever wants to update docs about world storage, the new procedure for going back to vanilla is to move these data files from <level-name (world default)>/dimensions/minecraft/overworld/data/minecraft to <level name>/data/minecraft

#

GameRuleMap.TYPE);
WeatherData.TYPE);
TimerQueue.TYPE);
WanderingTraderData.TYPE);```

#

and feel free to ping me with questions about it generally

pliant canopy Apr 3, 2026, 7:33 PM

#

I will include it in https://github.com/PaperMC/docs/pull/741

#

We can drop documentation about the pre-26.1 world migration, right?

#

What about migrating to Spigot? Is that something we should remove from the docs page as well?

scenic gull Apr 3, 2026, 7:35 PM

#

Worth keeping up the older vanilla bit at least until we have 26 stable imo.

pliant canopy Apr 3, 2026, 7:35 PM

#

Fair, will move them under a new header, similar to how userdev has the pre-mappings one

brazen moon Apr 3, 2026, 8:10 PM

#

there's a new system property too

pliant canopy Apr 3, 2026, 8:11 PM

#

Hell yeah

pliant canopy Apr 3, 2026, 9:16 PM

#

Okay so I need a simple yes or no: remove the migration docs for Spigot, both from and to?

#

Well, I guess from Spigot might still be useful, but I have no idea how their world structure stuff works, it might be so widly different that migrating might just be impossible?

eager plover Apr 3, 2026, 9:17 PM

#

We don't support migration from spigot

ocean void Apr 3, 2026, 9:17 PM

#

^

#

So remove them.

eager plover Apr 3, 2026, 9:17 PM

#

Like, and the versions we do support there are generally going to be older versions where we aligned so that's just akin to a paper upgrade as usual

ocean void Apr 3, 2026, 9:18 PM

#

It may be worthwhile to make a note that specifically mentions that we don't support migrations from Spigot, especially after 26.1 due to the difference in world structure.

pliant canopy Apr 3, 2026, 9:19 PM

#

Yeah, will do that

scenic gull Apr 3, 2026, 9:40 PM

#

Could mention users would need to migrate from spigot to vanilla for it. So nobody misses out on being able to enjoy paper?

pliant canopy Apr 3, 2026, 9:40 PM

#

That's a pretty good point, but does Spigot even offer any tutorials on that?

#

Or do we just say "figure it out on your own"?

scenic gull Apr 3, 2026, 9:44 PM

#

I dunno. I hope they have info on it somewhere.

pliant canopy Apr 3, 2026, 9:48 PM

#

random pollen ```WorldGenSettings.TYPE); GameRuleMap.TYPE); WeatherData.TYPE); TimerQueue.TYPE...

I don't have anything resembling WanderingTraderData when I started a 26.1.1 Paper test server. What would be the file name for that one?

scenic gull Apr 3, 2026, 9:49 PM

#

Maybe it doesn't happen until you get one?

pliant canopy Apr 3, 2026, 9:49 PM

#

Sure, but I am not gonna wait around until I get one

eager plover Apr 3, 2026, 9:50 PM

#

often the case with world data, that stuff is lazily populated for many parts iirc

random pollen Apr 3, 2026, 9:50 PM

#

did you stop the server yet

pliant canopy Apr 3, 2026, 9:50 PM

#

I did

random pollen Apr 3, 2026, 9:50 PM

#

did you login

pliant canopy Apr 3, 2026, 9:50 PM

#

Nope

#

I don't have a 26.1 mc instance on me atm

#

Lemme do that rq

random pollen Apr 3, 2026, 9:51 PM

#

I think it's needed for spawners to tick

#

#

after logging it it saved on shutdown

pliant canopy Apr 3, 2026, 9:52 PM

#

flashbang

#

Thank you jmp

pliant canopy Apr 3, 2026, 10:14 PM

#

If people could look over https://github.com/PaperMC/docs/commit/b6e60a23bf5d3a1177aadc84bae63866936125b0 for misinformation and style, I'd appreciate that

ocean void Apr 3, 2026, 10:15 PM

#

pliant canopy If people could look over <https://github.com/PaperMC/docs/commit/b6e60a23bf5d3a...

I would make it say something long ". . .making a direct migration as of 26.1 . . . "

pliant canopy Apr 3, 2026, 10:43 PM

#

@drowsy zinc we really need to do something against these abysmal build times

#

I have no idea what to do, so I'll let you look into it MahiruHeart

pliant canopy Apr 3, 2026, 10:44 PM

#

brazen moon there's a new system property too

Which sys property was added?

#

In case you just happen to know, if not, I'll look into it shortly

#

Alright @random pollen, I've updated the project setup page: https://papermc-update-26-1.papermc-docs.pages.dev/paper/dev/project-setup/. Done a bit more than just the versioning, also got rid of the groovy dsl because no one should use that + removed the mention of mappings, since it is not needed there. Anyways, mind checking over the dependency declaration stuff if that's all correct?

neon epoch Apr 3, 2026, 11:00 PM

#

pliant canopy <@504916819987922954> we ***really*** need to do something against these abysmal...

I mean, are they that bad?

#

It’s like 4 minutes from cold

pliant canopy Apr 3, 2026, 11:01 PM

#

Well, it's 4 minutes always

#

I get insane waiting for it

neon epoch Apr 3, 2026, 11:01 PM

#

I will try and remember to take a look tomorrow cause I think it’s just image processing

pliant canopy Apr 3, 2026, 11:01 PM

#

Yeah it is. Thank you

neon epoch Apr 3, 2026, 11:01 PM

#

I think you can cache it

pliant canopy Apr 3, 2026, 11:02 PM

#

We theoretically do

#

But I feel like scorp's D2 update might've caused it to be un-cached again

neon epoch Apr 3, 2026, 11:02 PM

#

👀

#

That’s odd

timid mulch Apr 3, 2026, 11:07 PM

#

As a note, the commits in the experimental tab lead to the Paper-Archive repo instead the Paper repo.

pliant canopy Apr 3, 2026, 11:08 PM

#

What experimental tab?

timid mulch Apr 3, 2026, 11:08 PM

#

*At the Downloads page

hearty briar Apr 3, 2026, 11:08 PM

#

if it is an old enough build then that would make sense

pliant canopy Apr 3, 2026, 11:09 PM

#

Oh yeah I see

#

@hard quartz do something about it, thx

#

I need to look through Paper source code in search of a newly added system propery sigh

neon epoch Apr 3, 2026, 11:10 PM

#

Get AI to do it

hearty briar Apr 3, 2026, 11:10 PM

#

https://github.com/PaperMC/website/blob/695a9849a21934ad7b77f3a94b797a0eb00f35b1/src/utils/github.ts#L62 code needs to be updated to support new versioning

pliant canopy Apr 3, 2026, 11:10 PM

#

I genuinely don't even know where to start looking

#

If someone just knows, please tell me

eager plover Apr 3, 2026, 11:11 PM

#

if !beginsWith 1; isBelow = false

#

make it somebody elses issue

hard quartz Apr 3, 2026, 11:13 PM

#

pliant canopy <@216316781483130880> do something about it, thx

Ah? confused_dog

eager plover Apr 3, 2026, 11:14 PM

#

the logic is hardcoded for 1.x; needs to be updated to support 26.X

pliant canopy Apr 3, 2026, 11:35 PM

#

Okay from my side I'd be done with updating the docs for 26.1. If people would be so kind as to look over that (dw I will rephrase that one thing, ocelot), I would greatly appreciate it

#

I might merge it somewhen tomorrow unless something else comes up

drowsy zinc Apr 3, 2026, 11:47 PM

#

pliant canopy But I feel like scorp's D2 update might've caused it to be un-cached again

your last change to the workflow essentially made it so the cache would never update even if was invalid

pliant canopy Apr 3, 2026, 11:47 PM

#

Cool

#

That's what happens when I touch CI

#

Anyways, I am off to bed

neon epoch Apr 4, 2026, 7:47 AM

#

ah thanks for looking at the cache scorp looks good, there are a fair few warnings with cached remote assets but they are just warnings and it looks to be handled gracefully so should be fine

drowsy zinc Apr 4, 2026, 11:25 AM

#

fixed

spice temple Apr 5, 2026, 8:29 AM

#

looks like astro 6 breaks bun?

#

spice temple Apr 5, 2026, 8:56 AM

#

somebody else will need to continue this https://github.com/PaperMC/website/pull/221

GitHub

update to astro 6 by MiniDigger · Pull Request #221 · PaperMC/web...

hard quartz Apr 5, 2026, 1:39 PM

#

Any issue if use mojira.dev over the attlasian portal in the docs?
the bugs-legacy throw issues by expired SSL and link to comments works bad a few times.

hard quartz Apr 5, 2026, 1:41 PM

#

spice temple

maybe for this?
https://github.com/withastro/astro/issues/15989#issuecomment-4090319021

spice temple Apr 5, 2026, 1:44 PM

#

hard quartz maybe for this? https://github.com/withastro/astro/issues/15989#issuecomment-409...

They do seo farm bun tho kekwhyper
https://docs.astro.build/en/recipes/bun/

Docs

Use Bun with Astro

Learn how to use Bun with your Astro site.

hard quartz Apr 5, 2026, 1:47 PM

#

2023 issue https://github.com/oven-sh/bun/issues/5951
well better move from bun? xd

GitHub

ws.WebSocket 'upgrade' and 'unexpected-response' event is not imple...

What version of Bun is running? Latest What platform is your computer? linux What steps can reproduce the bug? i got this warning when run my project. And ws connection getting terminate [bun] Warn...

spice temple Apr 5, 2026, 3:04 PM

#

Well, it breaks under node with pnpm too, see my PR

hard quartz Apr 5, 2026, 4:00 PM

#

i see i try check things like this breaking change... but still cannot find what other thing is broken for even load dev in local...

#

also try set in adapter the new config for the old behaviour (v5) and just make the error change xd

#

@spice temple
sorry the ping.. i make "run" with errors but now the site has a preview xd

spice temple Apr 5, 2026, 4:21 PM

#

Does it build? Lol

hard quartz Apr 5, 2026, 4:22 PM

#

yep

hard quartz Apr 5, 2026, 4:24 PM

#

spice temple Does it build? Lol

i ask now the IA in astro Discord for fix the last error because terminal and player count use the env removed... the IDE warns but now "works"

spice temple Apr 5, 2026, 4:26 PM

#

You can push to my branch, that seems like an improvement, lol

hard quartz Apr 5, 2026, 4:28 PM

#

spice temple You can push to my branch, that seems like an improvement, lol

wait i can?
i was to open annother PR to that branch xd

spice temple Apr 5, 2026, 4:29 PM

#

Idk do you have push perms on that repo?

#

Else just another PR, ye

hard quartz Apr 5, 2026, 4:33 PM

#

spice temple Idk do you have push perms on that repo?

remote: Permission to PaperMC/website.git denied to Doc94.
looks like not.. only in the docs repo because has my name or not sure DoggoHehe <

hard quartz Apr 5, 2026, 8:37 PM

#

green and also happy to remember i "patch" in the work a prettier for avoid mess with break lines xd
(because most of the people use WSL for touch code.. i use windows and every time touch that project the prettier change all)

spice temple Apr 5, 2026, 8:41 PM

#

You just need to disable core.autocrlf in git

#

Fuck that setting

#

Always input, always lf

hard quartz Apr 5, 2026, 8:49 PM

#

spice temple You just need to disable core.autocrlf in git

sure?

i remember try the same inn the work with the same result

random pollen Apr 5, 2026, 8:50 PM

#

try modifying the gitattributes like https://github.com/Incendo/cloud/blob/master/.gitattributes and then running git add --renormalize .

spice temple Apr 5, 2026, 8:51 PM

#

If you change that setting you need to reclone

#

Or renormalize I guess, not sure if that's enough

hard quartz Apr 5, 2026, 8:53 PM

#

working 😄 (i take that for reference in the work xd)
thanks

#

now only need wait for merge and known if cloudflare not fails in deploy a preview

viscid thistle Apr 5, 2026, 9:02 PM

#

Oooo Astro 6 update. Nice work.

random pollen Apr 5, 2026, 9:02 PM

#

why are we switching package manager though

viscid thistle Apr 5, 2026, 9:03 PM

#

That's a good question.

pliant canopy Apr 5, 2026, 9:06 PM

#

From what to what?

#

Hasn't the website been bun before as well?

hard quartz Apr 5, 2026, 9:07 PM

#

spice temple looks like astro 6 breaks bun?

for this this.

pliant canopy Apr 5, 2026, 9:07 PM

#

Ohh

#

Rip

hard quartz Apr 5, 2026, 9:08 PM

#

Astro also mention bun but its like "if you found issues go to bun repo and report" also a similar report in astro end with.

random pollen Apr 5, 2026, 9:08 PM

#

bun runtime is different from bun package manager

#

in prod it uses the workers runtime anyways

#

so idk why we would need to switch package manager, just don't pass --bun or set bun runtime in the bunfig.toml

hard quartz Apr 5, 2026, 9:11 PM

#

not sure why in the start the --bun was added.. how all start with the "bun and astro v6 mess with the web" i try first change from bun and later try to read the whole changelog for cloudflare workers

#

and how docs already use that

steady fulcrum Apr 6, 2026, 1:52 PM

#

forwarding it here so it doesn't get lost

eager plover Apr 6, 2026, 1:53 PM

#

already known

steady fulcrum Apr 6, 2026, 1:53 PM

#

Okay

deft verge Apr 6, 2026, 2:03 PM

#

Ohh..

hard quartz Apr 6, 2026, 2:11 PM

#

steady fulcrum forwarding it here so it doesn't get lost

pending in merge 3v_smile

eager plover Apr 6, 2026, 2:12 PM

#

I mean, idk who on docs team usually merges stuff, can hit the button if nobody else minds

steady fulcrum Apr 6, 2026, 2:15 PM

#

oh the old way we did that check is cursed OMEGALUL

hard quartz Apr 6, 2026, 2:15 PM

#

eager plover I mean, idk who on docs team usually merges stuff, can hit the button if nobody ...

the lasts was from Lead team xd
or can apply to docs teams too and self-merge DoggoHehe

pliant canopy Apr 6, 2026, 2:32 PM

#

eager plover I mean, idk who on docs team usually merges stuff, can hit the button if nobody ...

Docs? Isn't that website

steady fulcrum Apr 6, 2026, 2:32 PM

#

This is website yea

pliant canopy Apr 6, 2026, 2:33 PM

#

Last time I merged something on the website, lynx hit me with the eyes_roll emoji

steady fulcrum Apr 6, 2026, 2:33 PM

#

fwiw doc's changes are trivial and really can't break anything lol

pliant canopy Apr 6, 2026, 2:33 PM

#

I was just about to merge it

#

Thanks cat

steady fulcrum Apr 6, 2026, 2:33 PM

#

PEPW

pliant canopy Apr 6, 2026, 2:34 PM

#

I was already hovering over the green button

eager plover Apr 6, 2026, 2:34 PM

#

Yea, I thought it was on the docs thing 😄

pliant canopy Apr 6, 2026, 2:35 PM

#

cat, did you just do a merge commit

#

sadge

eager plover Apr 6, 2026, 2:35 PM

#

I hit the green button in my face

#

annoying

pliant canopy Apr 6, 2026, 2:35 PM

#

bonk

#

Lynx is gonna hunt you

eager plover Apr 6, 2026, 2:38 PM

#

bleh, can't force push it out either

pliant canopy Apr 6, 2026, 2:38 PM

#

Yeah, that's stuck there now

hard quartz Apr 6, 2026, 2:38 PM

#

ConterJuguito thanks for the merge

steady fulcrum Apr 6, 2026, 2:39 PM

#

pliant canopy cat, did you just do a merge commit

imagine not setting up the repo's rules smh

pliant canopy Apr 6, 2026, 2:40 PM

#

True

#

riley slacking

hard quartz Apr 6, 2026, 2:40 PM

#

xd
apply for web maintainer

pliant canopy Apr 6, 2026, 2:42 PM

#

I mean, I have the same perms on website as on docs to my knowledge

#

I've just learned to not merge on website

hard quartz Apr 6, 2026, 2:42 PM

#

i only in docs but i avoid touch that only for make PR

pliant canopy Apr 6, 2026, 2:42 PM

#

very good

steady fulcrum Apr 6, 2026, 2:43 PM

#

Is lynx a squasher?

pliant canopy Apr 6, 2026, 2:43 PM

#

We're all squashers

steady fulcrum Apr 6, 2026, 2:43 PM

#

very based

hard quartz Apr 6, 2026, 2:44 PM

#

but in website can be good for merge this and check if deploy a preview xd
that thing about cloudflare where PR created in forks are ignored for previews...

pliant canopy Apr 6, 2026, 2:44 PM

#

Testing on prod

#

kek

steady fulcrum Apr 6, 2026, 2:45 PM

#

oh yeah forks can't deploy to preview PEPW

pliant canopy Apr 6, 2026, 2:45 PM

#

Btw don't you have perms to open a branch on the main repo lol?

#

Why not do that

hard quartz Apr 6, 2026, 2:46 PM

#

pliant canopy Btw don't you have perms to open a branch on the main repo lol?

in website? nope

and in general when have i always use a fork for branchs xd unless need the repo CI

pliant canopy Apr 6, 2026, 2:46 PM

#

Huh, the more you know

#

I know you have commit perms on there though

#

Did you ever try it out?

hard quartz Apr 6, 2026, 2:48 PM

#

pliant canopy Did you ever try it out?

i try push to mini branch and get an error for permission

pliant canopy Apr 6, 2026, 2:48 PM

#

Well rip

steady fulcrum Apr 6, 2026, 2:49 PM

#

mfw I gotta taint my system with bun to do anything with website

pliant canopy Apr 6, 2026, 2:49 PM

#

Well, you know what

#

Doc

#

If mini will be mad

#

It's your fault

#

The build failed

#

KEKL

hard quartz Apr 6, 2026, 2:51 PM

#

spice temple You can push to my branch, that seems like an improvement, lol

@pliant canopy they allow that so...
for that merge was better the not squash xd

fair river Apr 6, 2026, 2:52 PM

#

riley will show up beside your bed tonight and look at you angrily.

pliant canopy Apr 6, 2026, 2:52 PM

#

Ofc it was squash

#

Gotta take revenge on cat not doing a squash

hard quartz Apr 6, 2026, 2:52 PM

#

well maybe fails for the change of the package manager... need wait mini or any with access to cloudflare for the logs xd

pliant canopy Apr 6, 2026, 2:53 PM

#

There's a very good chance that's true

steady fulcrum Apr 6, 2026, 2:53 PM

#

It's the build that fails. Vite struggles to rollup some astro related stuff.

#

Good news is with a little tweaks it builds fine and works fine in wrangler LUL

pliant canopy Apr 6, 2026, 3:01 PM

#

well, PR those tweaks

#

I am not afraid of lynx anymore

steady fulcrum Apr 6, 2026, 3:01 PM

#

I need to make sure they're actually sound and not dumb

pliant canopy Apr 6, 2026, 3:01 PM

#

He can eyes_roll me as much as he likes

neon atlas Apr 6, 2026, 3:01 PM

#

pliant canopy I am not afraid of lynx anymore

You should be

pliant canopy Apr 6, 2026, 3:01 PM

#

Aren't you like on vacation or something

neon atlas Apr 6, 2026, 3:01 PM

#

Technically

hard quartz Apr 6, 2026, 3:02 PM

#

steady fulcrum Good news is with a little tweaks it builds fine and works fine in wrangler <:LU...

the astro 6 branch?

steady fulcrum Apr 6, 2026, 3:02 PM

#

Yeah

pliant canopy Apr 6, 2026, 3:03 PM

#

It might just not work anyways

hard quartz Apr 6, 2026, 3:03 PM

#

you change the packagemanager or just run dev?

steady fulcrum Apr 6, 2026, 3:03 PM

#

You can npx wrangler dev to force wrangler to run

#

probably can bunx it too

hard quartz Apr 6, 2026, 3:03 PM

#

well i feel fine if keep the same packagemanager than docs site...

pliant canopy Apr 6, 2026, 3:04 PM

#

I've been wanting to replace docs with bun for a while now too, but if astro breaks anyways, what's the point

steady fulcrum Apr 6, 2026, 3:04 PM

#

I'm pretty sure it's just broken from weird astro 5 -> 6 things

hard quartz Apr 6, 2026, 3:04 PM

#

well i dont try what jmp says about change configs.. but if astro add warnings for bun...

steady fulcrum Apr 6, 2026, 3:05 PM

#

bunx wrangler dev also worked fine

hard quartz Apr 6, 2026, 3:05 PM

#

i dont like changes in web things every version has many breaking changes..

steady fulcrum Apr 6, 2026, 3:05 PM

#

You'll have to build first or wrangler will probably bitch

hard quartz Apr 6, 2026, 3:06 PM

#

well if wanna try move again to bun and make a PR can test if the mini PR finally deploy xd

pliant canopy Apr 6, 2026, 3:06 PM

#

Go ahead

steady fulcrum Apr 6, 2026, 3:06 PM

#

I'll make a quick PR to mini's branch

pliant canopy Apr 6, 2026, 3:18 PM

#

Well, let's see

steady fulcrum Apr 6, 2026, 3:19 PM

#

brother

#

it failed the lint

#

MAAAN

pliant canopy Apr 6, 2026, 3:19 PM

#

kekw

#

Incredible

steady fulcrum Apr 6, 2026, 3:19 PM

#

but not locally

#

wtf

pliant canopy Apr 6, 2026, 3:19 PM

#

The build seems to be in progress though

#

Wtf it worked

steady fulcrum Apr 6, 2026, 3:20 PM

#

it was just a type error

#

so it'll compile fine

pliant canopy Apr 6, 2026, 3:20 PM

#

Okay that's great

#

Lemme quickly fix the lint issues

#

So are we using bun or pnpm now?

steady fulcrum Apr 6, 2026, 3:21 PM

#

bun just calls pnpm

#

OMEGALUL

pliant canopy Apr 6, 2026, 3:21 PM

#

KEKWHYPER

#

So should I use the bun or the pnpm command?

steady fulcrum Apr 6, 2026, 3:22 PM

#

I've been using bun

#

but the readme says pnpm

pliant canopy Apr 6, 2026, 3:22 PM

#

I'll probably go with pnpm

steady fulcrum Apr 6, 2026, 3:22 PM

#

so probably follow that

hard quartz Apr 6, 2026, 3:23 PM

#

so context has a env... i was sure was removed

steady fulcrum Apr 6, 2026, 3:23 PM

#

The type errors are probably a bad import from workers or something

pliant canopy Apr 6, 2026, 3:23 PM

#

So, the thing does not build for me

#

kek

#

Oh wait

#

I didn't pnpm i

#

Oh yeah interesting, some runtime missing

steady fulcrum Apr 6, 2026, 3:24 PM

#

I think it's a bad import on my end

pliant canopy Apr 6, 2026, 3:25 PM

#

Lemme work my magic on this

#

Hm, now that's interesting

steady fulcrum Apr 6, 2026, 3:30 PM

#

okay weird the way mini did KV access originally is correct

pliant canopy Apr 6, 2026, 3:30 PM

#

Just gotta declare it in env.d.ts

steady fulcrum Apr 6, 2026, 3:30 PM

#

why did it not build then

junior galleon Apr 6, 2026, 3:30 PM

#

because u didnt do it correctly

pliant canopy Apr 6, 2026, 3:30 PM

#

Well, env is still missing

#

Fixed it 👍

scenic gull Apr 6, 2026, 3:34 PM

#

@junior galleon let's stick to helpful remarks, thanks

steady fulcrum Apr 6, 2026, 3:34 PM

#

According to https://docs.astro.build/en/guides/integrations-guide/cloudflare/#environment-variables-and-bindings the whole astro:env/server thing originally there should've worked

#

Unsure why it didn't

pliant canopy Apr 6, 2026, 3:35 PM

#

I mean, the thing I did there should hopefully be fine now, we'll see what cf says about it though

steady fulcrum Apr 6, 2026, 3:35 PM

#

It'll be fine, it was solely a type error failing

pliant canopy Apr 6, 2026, 3:35 PM

#

Yeah

#

Also why is the build cache just straight up disabled

steady fulcrum Apr 6, 2026, 3:37 PM

#

That whole check workflow is kinda flawed

#

It just runs a lint and type check, doesn't even build LUL

pliant canopy Apr 6, 2026, 3:37 PM

#

Only run on PRs if the source branch is on someone else's repo
What does that mean

#

So we just don't get linting if it's the same repo?

#

Lol

steady fulcrum Apr 6, 2026, 3:38 PM

#

yes for some reason

pliant canopy Apr 6, 2026, 3:38 PM

#

Let's maybe not do that, that smells like bad design

steady fulcrum Apr 6, 2026, 3:38 PM

#

Oh apparently we do cache, just kinda not really

pliant canopy Apr 6, 2026, 3:39 PM

#

Well, we don't cache sharp

steady fulcrum Apr 6, 2026, 3:39 PM

#

So that cache toggle is for images

#

Yeah

pliant canopy Apr 6, 2026, 3:39 PM

#

Which feels kinda important I feel like

steady fulcrum Apr 6, 2026, 3:39 PM

#

It would be if the action ran a build

#

But since it doesn't it doesn't really do anything OMEGALUL

pliant canopy Apr 6, 2026, 3:39 PM

#

GHomegaLUL

#

So what's the point of that then

steady fulcrum Apr 6, 2026, 3:41 PM

#

It should probably also pnpm run build in a 2nd job after the lint and checks pass.

#

Then it'd be a full workflow for testing

pliant canopy Apr 6, 2026, 3:42 PM

#

Hm, I would almost put that in a separate workflow

#

linting and building are two things

steady fulcrum Apr 6, 2026, 3:42 PM

#

Can you cross workflow depends Hmm

pliant canopy Apr 6, 2026, 3:42 PM

#

I believe so, yes

#

But we can run build and check separately

steady fulcrum Apr 6, 2026, 3:43 PM

#

I mostly meant it so you could not build unless the tests pass since there's no point in building what is bad to begin with

pliant canopy Apr 6, 2026, 3:43 PM

#

I am not sure, that'd probably be a CF configuration then

#

I don't have access to that

steady fulcrum Apr 6, 2026, 3:43 PM

#

I can PR it LUL

pliant canopy Apr 6, 2026, 3:43 PM

#

Hm?

#

The previews are done by CF, not by a workflow

steady fulcrum Apr 6, 2026, 3:44 PM

#

Yes but you can still build

pliant canopy Apr 6, 2026, 3:44 PM

#

Yes I can

#

And I intend to do that

#

But I cannot make it so that the preview doesn't happen if the build fails

steady fulcrum Apr 6, 2026, 3:44 PM

#

this is why you put the deploy in as a workflow too

pliant canopy Apr 6, 2026, 3:44 PM

#

I believe we do that in the docs

#

Eh, this is something that needn't be part of the astro 6 branch

random pollen Apr 6, 2026, 3:48 PM

#

still don't get why we're changing package managers

pliant canopy Apr 6, 2026, 3:48 PM

#

No idea either

#

I thought bun worked fine

random pollen Apr 6, 2026, 3:49 PM

#

it does, it was wrongly switched due to confusion of bun runtime vs bun package manager

pliant canopy Apr 6, 2026, 3:49 PM

#

I remember that convo. However, do local dev previews work with bun?

#

Because I kinda feel like that was one problem with astro 6 and bun

hard quartz Apr 6, 2026, 3:49 PM

#

when take the mini branch no

random pollen Apr 6, 2026, 3:50 PM

#

https://github.com/PaperMC/website/blob/main/bunfig.toml#L3

#

you just need to remove this if bun runtime doesn't work anymore in v6

pliant canopy Apr 6, 2026, 3:50 PM

#

Hm, lemme test this

#

Oh yeah

#

Nice

#

Okay lemme undo the bun->pnpm move

#

Oh woops, needs node anyways

#

Since it's not using the bun runtime

#

Okay there we go, that should do it

hard quartz Apr 6, 2026, 4:03 PM

#

if Ci use node 24 then the package.json can declare min 24 too?

pliant canopy Apr 6, 2026, 4:03 PM

#

Yeah

#

Lol bun run build froze at prerendering paper-1-19 news

hard quartz Apr 6, 2026, 4:06 PM

#

xd

pliant canopy Apr 6, 2026, 4:06 PM

#

Okay fixed itself after a restart

hard quartz Apr 6, 2026, 4:07 PM

#

i hope can have write acces...
but you can change also the packageManager in package.json and the runtime in devEngines?

pliant canopy Apr 6, 2026, 4:07 PM

#

Right

#

devEngine I already did

#

(Locally)

#

need packagemanager

#

Bun is not technically accepted into the packageManager field

#

So I guess just remove that field

hard quartz Apr 6, 2026, 4:15 PM

#

and now why Cloudflare is angry again ._.

pliant canopy Apr 6, 2026, 4:15 PM

#

I am guessing node version

#

Yep

#

Well whatever

#

@spice temple we did some changes to your PR. It's back to bun as the package manager, just using node as the runtime, and everything compiles now correctly

hard quartz Apr 6, 2026, 4:18 PM

#

the only change can be if wanna touch the worker for make run in node 24
not sure if worker allow define in a file like pages

pliant canopy Apr 6, 2026, 4:20 PM

#

Honestly, doesn't look like it

hard quartz Apr 6, 2026, 4:20 PM

#

looks like you can
https://developers.cloudflare.com/workers/ci-cd/builds/build-image/

Cloudflare Docs

Build image

Understand the build image used in Workers Builds.

pliant canopy Apr 6, 2026, 4:20 PM

#

At least I canoot find the setting for it on my site

#

Okay cool

#

But like where?

hard quartz Apr 6, 2026, 4:22 PM

#

in General

steady fulcrum Apr 6, 2026, 4:23 PM

#

pliant canopy But like *where*?

what happens when you desync from your wrangler file classic

spice temple Apr 6, 2026, 4:45 PM

#

pliant canopy <@134340832093405184> we did some changes to your PR. It's back to bun as the pa...

Nice

#

Is it all working now?

pliant canopy Apr 6, 2026, 4:46 PM

#

Yes

#

At least to my knowledge

spice temple Apr 6, 2026, 4:46 PM

#

That's not enough certainty for me to merge it on my phone kekwhyper

pliant canopy Apr 6, 2026, 4:47 PM

#

Clicking through the preview site looks fine

steady fulcrum Apr 6, 2026, 4:47 PM

#

it looks and works fine from my brief testing

spice temple Apr 6, 2026, 4:47 PM

#

Am still stuck at my parents but I wanna boot my PC once I am at home anyways, gotta do some accounting, woo

pliant canopy Apr 6, 2026, 4:47 PM

#

Take your time, not like merging this is critical

steady fulcrum Apr 6, 2026, 4:48 PM

#

it is

#

I will die without it

pliant canopy Apr 6, 2026, 4:49 PM

#

Oh okay

#

Let's wait for a few months then

hard quartz Apr 6, 2026, 4:49 PM

#

is, give perms and i merge and also close the renovate PR xd

pliant canopy Apr 6, 2026, 4:49 PM

#

I mean I can merge it too, no problem

#

We are not exactly short of mergers

#

But I think mini should at least look over it once

eager parcel Apr 6, 2026, 5:09 PM

#

Are the 26.1.1 javadocs broken for anyone else? My browser doesn't want to connect

random pollen Apr 6, 2026, 5:10 PM

#

yes its not working yet

eager parcel Apr 6, 2026, 5:10 PM

#

Oh alright. The link to the javadocs was already updated to 26.1.1, so I expected it to work

spice temple Apr 6, 2026, 7:33 PM

#

thats done automatically

spice temple Apr 6, 2026, 7:35 PM

#

spice temple Is it all working now?

thanks guys

viscid thistle Apr 6, 2026, 11:06 PM

#

Great work all!

frail valley Apr 7, 2026, 4:34 AM

#

https://docs.papermc.io/paper/dev/project-setup/#the-main-class

The main class
The way this section is worded ever so slightly implies that you should have a class named main, even though the example shows a different entry class name.

Since naming a class "main" is usually considered bad practice in bukkit-derivative development, is this something which should be edited? If so, I'm willing to make a PR.

serene vault Apr 7, 2026, 4:37 AM

#

the entry in plugin.yml is called main:, so I think that naming is generally fine. But maybe sentence about not naming it literally Main could be added there

frail valley Apr 7, 2026, 5:06 AM

#

Yeah I was more talking about editing the section, not changing the title

neon epoch Apr 7, 2026, 7:45 AM

#

Is this just because it’s not actually the entrypoint for the program & also could be class path clashes if every plugin has a Main.java?

spice temple Apr 7, 2026, 9:13 AM

#

it makes reading code and strack traces/logs a bit meh

#

no technical reason

pliant canopy Apr 7, 2026, 10:00 AM

#

I mean, if others add your plugin as a dependency, CryptoScamPlugin is much more descriptive than Main

#

I see it more as a "Class names should be somewhat descriptive"

spice temple Apr 7, 2026, 10:50 AM

#

that was the "reading code" part 😛

pliant canopy Apr 7, 2026, 11:00 AM

#

I'll let that one slide

#

giggle

hard quartz Apr 7, 2026, 2:09 PM

#

Design is my passion xd
i try the guide for tags in content... not like the design but the logic for take tags from news and make lists or show posts with that works xd

thorn brook Apr 7, 2026, 3:05 PM

#

not sure if this is the correct channel, but https://jd.papermc.io/paper/26.1.1/org/bukkit/event/block/BlockExplodeEvent.html seems to be broken, returning no content

sharp pivot Apr 7, 2026, 3:29 PM

#

cloudflare caches a bad response sometimes

thorn brook Apr 7, 2026, 4:35 PM

#

ah

#

yea it cached a 304 not modified, it works now

hard quartz Apr 7, 2026, 7:44 PM

#

hard quartz Design is my passion xd i try the guide for tags in content... not like the desi...

ok... with a little of help i think looks better now.

viscid thistle Apr 8, 2026, 3:54 PM

#

Pulled the latest updates locally and I'm realizing that the image optimization isn't actually working. While it creates multiple copies of the image for different device sizes, they are all the same size as the original. Our dist folder is over 250MB because of this 😛

pliant canopy Apr 8, 2026, 3:55 PM

#

kekwpain

viscid thistle Apr 8, 2026, 3:57 PM

#

Been trying to debug it, but I can't really figure out why.

#

Looks like a known issue:

#

Opening a PR with a temp fix. I'll make sure to note it.

#

Oh jk. It doesn't actually apply the fix in the CI for workers, only locally.

hard quartz Apr 8, 2026, 4:16 PM

#

viscid thistle Oh jk. It doesn't actually apply the fix in the CI for workers, only locally.

that change works?
i add because in local just not start working...

viscid thistle Apr 8, 2026, 4:17 PM

#

I confirmed what I was going to PR does apply the image optimizations locally, but when done in the worker CI environment, it doesn't apply it. I think we might just have to wait for fixes.

#

Looks like we're waiting on this PR: https://github.com/withastro/astro/pull/16194

hard quartz Apr 8, 2026, 4:19 PM

#

viscid thistle Looks like we're waiting on this PR: <https://github.com/withastro/astro/pull/16...

you can open an issue in website? for mark blocked with that issue and keep follow

viscid thistle Apr 8, 2026, 4:20 PM

#

I can if you'd like. It'll probably be merged in with @astrojs/cloudflare@13.1.9 / 13.2.0 and it'll auto pick up when we update dependencies and fix itself 🙂

hard quartz Apr 8, 2026, 4:21 PM

#

viscid thistle I can if you'd like. It'll probably be merged in with `@astrojs/cloudflare@13.1....

nice

viscid thistle Apr 8, 2026, 4:25 PM

#

Alright, opened an issue for tracking.

hard quartz Apr 8, 2026, 4:27 PM

#

added reference, thanks Github for allow that 🙂

viscid thistle Apr 8, 2026, 4:28 PM

#

Didn't know that was a thing. Cool.

hard quartz Apr 8, 2026, 4:34 PM

#

yeah very useful for that things

spice temple Apr 9, 2026, 6:21 AM

#

At work I would take this chance to write unit tests for bundle size and image size, do we care about that here too?

#

Maybe just one script that checks the size of the dist folder as a safeguard is enough

hard quartz Apr 9, 2026, 11:26 AM

#

Why not jeb_curious