Add support for Verse programming language

[simnJS]

Description

Verse is the multi-paradigm programming language developed by Epic Games for Unreal Editor for Fortnite (UEFN) and Fortnite Creative 2.0. Epic Games has publicly announced Verse as the official scripting language for Unreal Engine 6.

References:

• Official documentation: https://dev.epicgames.com/documentation/en-us/uefn/verse-language-reference
• Community Book of Verse (CC0-1.0): https://verselang.github.io/book/
• Epic Games maintains an official VS Code extension (epicgames.verse) registering the .verse, .versetest, and .vson extensions with the source.verse TextMate scope. This PR only registers .verse for now.

Checklist:

• I am adding a new language.
  • Search showing in-the-wild usage:
    • https://github.com/search?type=code&q=NOT+is%3Afork+path%3A*.verse+using
  • Real-world usage samples included (added via the script/add-grammar workflow):
    • samples/Verse/Hexadecimal.verse
      • Source: https://github.com/sprintermax/UEFNVerseSnippets/blob/main/VerseLogic/ExtraModules/Encoding/Hexadecimal.verse
      • License: MIT
    • samples/Verse/ConcurrencyFeatures.verse
      • Source: https://github.com/sprintermax/UEFNVerseSnippets/blob/main/VerseLogic/ExtraModules/ConcurrencyFeatures.verse
      • License: MIT
  • Syntax-highlighting grammar added via script/add-grammar:
    • https://github.com/simnJS/verse-grammar (MIT)
  • Color added — Hex #518ef8 (Epic Games' official Verse branding color)
  • Heuristics — not needed, .verse is not currently mapped to any other language

[sprintermax]

We really need this!
Here are some more good code examples of verse syntax:
https://github.com/sprintermax/UEFNVerseSnippets/blob/main/VerseLogic/ExtraModules/VerseFeatures.verse
https://github.com/sprintermax/UEFNVerseSnippets/blob/main/VerseLogic/ExtraModules/MathFeatures.verse
https://github.com/RayBenefield/dev-xp/blob/master/src/node_modules/%40tableau/device/selector_device_v0_1.verse

[lildude]

Please follow the instructions in COMTRIBUTING.md. We don't need any other files or changes outside of those produced by following the docs.

[simnJS]

I’ve checked the CONTRIBUTING.md and I believe I’ve addressed all the issues. Apologies for the incomplete first PR.

[lildude]

We need the cached license file from the grammar repo. It would have been created when you ran script/add-grammar to add the grammar.

I have included a real-world usage sample for all extensions added in this PR:

Sample source(s):
https://github.com/simnJS/linguist/blob/main/samples/Verse/events.verse
https://github.com/simnJS/linguist/blob/main/samples/Verse/int.verse

This part of the template needs to point to the actual source of the samples, not your fork of Linguist. The license section also needs to state the license of the samples.

[simnJS]

Hi, thanks for the feedback!

I understand the concern about popularity. However, I'd like to highlight a few important points that reflect the growing strategic relevance of the Verse language:

• Verse is the official scripting language for Fortnite Creative 2.0 and Unreal Editor for Fortnite (UEFN), as documented by Epic Games here.

• Epic has publicly stated its long-term goal is to make Verse the default programming language across the entire Unreal Engine ecosystem. This positions Verse not as a niche tool, but as a foundational part of future Unreal development, including Fortnite, UEFN, and eventually Unreal Engine itself.

• Verse is already widely used in production by professional studios, particularly in private repositories and packaged UEFN experiences. This unfortunately limits the visibility of .verse files on GitHub search, despite significant real-world usage.

• Supporting .verse in Linguist would directly encourage open-source sharing by making GitHub a more welcoming platform for Verse developers. Right now, many avoid publishing their work here due to the lack of syntax highlighting.

Let me know if you'd like any more concrete usage examples or documentation references—happy to help!

Thanks again for your time and consideration.

[lildude]

The popularity requirements are only made based on public repos as it's impossible to tell what private usage is. Yes, this does result in a chicken-and-egg scenario between encouraging usage and getting it recognised on GitHub, but this applies for all new languages and projects, regardless of backing. We don't make exceptions either as this would defeat the purpose of having a usage requirement which means we'd have to effectively pollute and degrade the quality of this project by accepting every hobby language submission too.

Popularity is evaluated every 3-4 months when a new release is made, so if this language is really gaining in popularity as you claim, it shouldn't take long to meet our usage requirements.

[simnJS]

Okay thank you ! How did you check popularity for verse ? I don't find a query to see numbers of repo using it.

[lildude]

Okay thank you ! How did you check popularity for verse ? I don't find a query to see numbers of repo using it.

I used the search link you provided. I also removed the using keyword to see if that made much of a difference; it didn't. It's not possible to easily determine the number of repos from the search results at the moment, hence we're using the temporary calculating method detailed in the issue referenced in the CONTRIBUTING.md file.

[lildude]

I looks like you didn't use the script/add-grammar script to add your grammar as per the CONTRIBUTING.md file as had you done so, it would have failed with a source 'vendor/grammars/verse-grammar' contains no grammar files error because your grammar repo is not in a format used by editors.

We expect the grammar files to be in these locations, depending on the extension. Your grammar repo isn't.

Please fix your grammar repo and re-add your grammar.

[simnJS]

I looks like you didn't use the script/add-grammar script to add your grammar as per the CONTRIBUTING.md file as had you done so, it would have failed with a source 'vendor/grammars/verse-grammar' contains no grammar files error because your grammar repo is not in a format used by editors.

We expect the grammar files to be in these locations, depending on the extension. Your grammar repo isn't.

Please fix your grammar repo and re-add your grammar.

Hi, sorry about that — I thought I had followed the steps correctly, but I clearly misunderstood. This is actually the first project I’m contributing to, so I really appreciate your guidance.

I’ll work on fixing the grammar repo in the next few hours and re-add it properly.

Just to confirm, does Verse already meet the popularity requirement to be accepted as a supported language?

Thanks again for your help!

[simnJS]

Hello, the Verse language is becoming increasingly popular! It was officially announced last month as the official language of Unreal Engine 6. It’s even being taught in some schools. Do you think the language still deserves its “pending popularity” status?

[lildude]

Popularity is only reassessed when I'm preparing to make a new release which happens approx every 3-4 months. If it meets our requirements and the PR's tests pass, the PR will be merged. I will not add a comment each time as this is unnecessary noise telling you what the label does.

[lildude]

It also still looks like you've still not used the script/add-grammar. Please do so as it'll save everyone time when the language is reassessed.

[simnJS]

Hi @lildude, I've fully redone this PR following CONTRIBUTING.md step by step:

• rebased on upstream/main
• used script/add-grammar (grammar repo restructured + non-standard keys cleaned up grammars/verse.tmLanguage.json now compiles without warnings)
• replaced my hand-written samples with real-world MIT-licensed code from sprintermax/UEFNVerseSnippets, with proper source/license attribution in the PR body
• updated the PR description with explicit references

All three previously-failing tests (test_submodules_are_sorted, test_all_languages_have_grammars, test_submodules_are_in_sync) pass locally. Ready for re-evaluation at the next release window. Thanks for your patience.

[simnJS]

Fixed the Check Licenses failure: the cached verse-grammar.dep.yml was pointing at the old submodule SHA after I bumped the grammar. Re-ran bundle exec licensed cache and amended. New HEAD: eafe54dc.

[lildude]

samples/Verse/VerseFeatures.verse is too big for our needs (if it's suppressed in the diff, it is too big). Please replace it with a smaller sample.

[simnJS]

Thanks for the quick review! Replaced VerseFeatures.verse with Hexadecimal.verse (~5 KB, same MIT-licensed source). Should display properly in the diff now.