> For the complete documentation index, see [llms.txt](https://hiveminddocs.gitbook.io/hivemind/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hiveminddocs.gitbook.io/hivemind/code-systems/ultimate-building-system-framework-ubs/global-function-references.md).

# Global Function References

These functions are designed to help you easily retrieve the information you need from outside any of the classes. For example, you can use them to query specific types, such as actions, if you need to access a default action or similar functionality.

## Functions

* `GetUltimateBuildingDeveloperSettings()`:\
  Returns the `UUBF_DeveloperSettings` for the Ultimate Building System.
* `GetSocketName()`:\
  Returns the default socket name for the system.
* `QueryFirstBuildableActionByTag()`:\
  Retrieves the first buildable action that matches the specified `TagQuery`.
* `QueryBuildableActionsByTag()`:\
  Finds and returns all buildable actions that match the specified `TagQuery`.
* `QueryFirstBuildableByTag()`:\
  Retrieves the first buildable that matches the `TagQuery` from a list of buildables.
* `QueryBuildablesByTag()`:\
  Finds and returns all buildables that match the `TagQuery` from a list of buildables.
* `QueryFirstBuildableSocketByTag()`:\
  Retrieves the first buildable socket that matches the `TagQuery` for a given buildable.
* `QueryBuildableSocketsByTag()`:\
  Finds and returns all buildable sockets that match the `TagQuery` for a given buildable.
* `QueryFirstBuildableDefinitionByTag()`:\
  Retrieves the first buildable definition that matches the `TagQuery` from a list of buildable definitions.
* `QueryBuildableDefinitionsByTag()`:\
  Finds and returns all buildable definitions that match the `TagQuery` from a list of buildable definitions.

## Query Example

Using a query function is pretty simple. The illustration below shows how you can get the first found attachable on the `this` buildable with the foundation type tag.

<figure><img src="/files/b8mUpRJsTlDVVUUH2s2Q" alt=""><figcaption><p>Querying the first found Buildable with a Foundation Type Tag which is attached to this buildable.</p></figcaption></figure>

{% hint style="info" %}
Note: You can decide to use the array versions of the Query functions to get all the objects which matches the tag query as well.
{% endhint %}

{% hint style="info" %}
Note: Query functions are looking for owned gameplay tags. These tags are defined in the buildable definition. So anywhere you see "owned tags" is the tags that the query functions will look for.
{% endhint %}

{% hint style="warning" %}
Warning: Tag Qualifiers added to a buildable definition will add extra tags to buildables if they pass their qualification condition. This means you might get Buildables which shares the same tag type, such as a pillar that has a Foundation Tag Qualifier Condition might appear on a `Structure.Type.Foundation` Query Buildable Search as it would qualify as a foundation if its placed on a foundation on in the ground.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://hiveminddocs.gitbook.io/hivemind/code-systems/ultimate-building-system-framework-ubs/global-function-references.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.