renderdragon-shaders

An unofficial documentation webpage about RenderDragon shaders, built using Vitepress.

This webpage builds upon Render-dragon-shader-list, addressing some of its drawbacks in displaying contents efficiently for an average user. It also extends by providing documentation and resources on making custom shaders for RenderDragon.

Note

You can contribute to this documentation in the following ways:
๐Ÿกข Opening an issue
๐Ÿกข Forking repository and making a PR

See contributing section for more info.

Progress

  • Home page
  • Installation guide (Android/Win/iOS/Linux)
  • Documentation
    • Building (Win/Linux)
    • Utilities
    • Extras
    • Code Snippets
  • Shaders List
    • RD List
    • Deferred List

Pages structure

๐Ÿ“‚ docs
โ”œโ”€๐Ÿ“‚ .vitepress
โ”‚  โ””โ”€๐Ÿ“‚ locales
โ”‚     โ”œโ”€๐Ÿ“„ en.ts
โ”‚     โ””โ”€๐Ÿ“„ ko.ts     ๐Ÿก  Korean version of en.ts
โ”œโ”€๐Ÿ“‚ public          ๐Ÿก  Images
โ”œโ”€๐Ÿ“‚ ko              ๐Ÿก  Korean version of pages
โ”œโ”€๐Ÿ“‚ docs            ๐Ÿก  RD docs
โ”œโ”€๐Ÿ“‚ shaders
โ”‚  โ”œโ”€๐Ÿ“‚ installation ๐Ÿก  Installation guides
โ”‚  โ”œโ”€๐Ÿ“‚ list
โ”‚  โ”‚  โ”œโ”€๐Ÿ“‚ rd        ๐Ÿก  RD shaders
โ”‚  โ”‚  โ””โ”€๐Ÿ“‚ deferred  ๐Ÿก  Deferred RD shaders
โ”‚  โ””โ”€๐Ÿ“„ start.md     ๐Ÿก  Shaders page
โ””โ”€๐Ÿ“„ index.md        ๐Ÿก  Home page

Setup

You will need node.js and npm

Install dependencies

npm install

Start local server for realtime preview

npm run docs:dev

Contributing

You can contribute by either forking this repo and making a PR, or by opening an issue with required details.

1. Improve or update content

You can help in improving the documentation by fixing typos, rectifying incorrect information, adding more details, or updating shaders.

2. Write docs

You can add new sections in documentation to cover resources that you think might help others. If you want to create a new page for the same, create a new .md file in docs/docs/ and link this to the documentation sidebar in en.ts

3. Add shaders

  1. Create a new file, shader-name.md inside:

    • shaders/list/deferred for Deferred RenderDragon shader
    • shaders/list/rd for RenderDragon shader
  2. Add the following details to that file: (Refer to existing files to understand better)

    ---
    name: <Shader name>
    tags: <Supported platforms>
    banner: <Banner image url>
    last_updated: <Latest pack update date, YYYY-M-D format>
    ---
    
    # <Shader name>
    
    <Gallery
    :images="<Screenshot urls>"
    />
    
    ### Description
    
    <Description of the shader>
    
    * Source code: <Optional>
    * Supported platforms: <Supported platforms>
    * Discord server: <Optional>
    * <More details if required> 
    
    ### Download
    
    ::: tip <Version code>
     * <Download link>
    :::
    
  3. Add screenshots inside public/images/:

    • Name: shader-name-<number>.jpg
      shader-name-0.jpg should be used as the banner image
    • Type: jpg (under 250kb)
    • Number: At least 3 images, maximum allowed is 8
  4. Preview and verify the changes before making a pull request

Note

This webpage/repository has no affiliation with Mojang Studios or Minecraft. RenderDragon and its assets are solely owned by Mojang Studios.