Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Opinionated full lore entry rewrite (free for adaptation) #4

Open
wants to merge 9 commits into
base: 1.21.4
Choose a base branch
from

Conversation

sisby-folk
Copy link
Contributor

@sisby-folk sisby-folk commented Jan 6, 2025

Hello!

We maintain a modpack (Tinkerer's Quilt) that puts quite a lot of effort into explaining vanilla game concepts and content progression to the player. For this, we decided to write our own full set of descriptions that suit our own prose style.

You're completely welcome to use or adapt any of it piecemeal or wholesale if it helps you! We'll be putting it in our pack and we'll probably make a modrinth respack as well - if that's ever made redundant, let us know.

principles vaguely used:

  • Tooltips should be short and easy to read.
  • Tooltips should mostly make sense when read "[Subject Name], [Tooltip]"
  • Tooltips should elide information available in EMI (+Trades +Loot +Ores) or WAILA unless they're essential or reflect the primary purpose of the subject.
  • Tooltips should be aware of where they're likely to be first read. For example, natural block tooltips note alternate drops, because the player will see them first through WAILA.
  • All april fools tooltips should include the word "strange" as early as possible in the tooltip, and no vanilla items should include that word.
  • All entities follow A [adjectives] [thing] (found in [Place]) (that does/is stuff).
  • All mobs should be described as passive/neutral/hostile mobs, and can use the qualifiers ambient, aquatic, flying ranged [hostile] undead unused

Thanks for the inspiration! And feel free to close this one any time.

add block lore for wood/stone button tags
add entity lore for allays, arrows, and minecart variants
remove grass_path (unused) and silence (redundant) lore
logs: smelted into -> smelted to make
blue ice: an extremely slippery block
@cassiancc
Copy link
Owner

cassiancc commented Jan 6, 2025

This is a very interesting refactor. I had them shorter like this originally, but I went and expanded them later as I felt the sentence structure worked better - I hadn't thought of reading it like "[Subject Name], [Tooltip]". As you probably found, there's still one or two that are in that older style. Your principles are good, with your permission I'd definitely like to include something similar on the wiki.

I do feel like the loss of rarity as part of the description is a shame. Mojang's rarity system isn't very well communicated, so including the text of the rarity name would help... as soon as I figure out how to format that without the word "item" present.

@cassiancc cassiancc changed the base branch from 1.21.1 to 1.21.4 January 6, 2025 16:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants