Merge branch 'api-14' into api-14-consume-effects

Author: MrHell228

src/main/java/org/spongepowered/api/adventure/ResolveOperations.java

@@ -68,6 +68,11 @@ public final class ResolveOperations {
      */
     public static final DefaultedRegistryReference<ResolveOperation> CUSTOM_TRANSLATIONS = ResolveOperations.key(ResourceKey.sponge("custom_translations"));
 
+    /**
+     * Resolves Sponge provided virtual components.
+     */
+    public static final DefaultedRegistryReference<ResolveOperation> VIRTUAL_COMPONENTS = ResolveOperations.key(ResourceKey.sponge("virtual_components"));
+
     // SORTFIELDS:OFF
     // @formatter:ON
 

src/main/java/org/spongepowered/api/adventure/SpongeComponents.java

@@ -119,10 +119,28 @@ public static ComponentFlattener flattener() {
      * render each {@link Audience} their own version of
      * the received message.
      *
+     * @param apply The function invoked to render
+     *              {@link Audience} specific component.
      * @return The virtual component
      */
     public static VirtualComponent receiverVirtualComponent(final Function<Audience, ComponentLike> apply) {
-        return SpongeComponents.factory().receiverVirtualComponent(apply);
+        return SpongeComponents.receiverVirtualComponent(apply, "");
+    }
+
+    /**
+     * Creates a new {@link VirtualComponent} that will be used to
+     * render each {@link Audience} their own version of
+     * the received message.
+     *
+     * @param apply The function invoked to render
+     *              {@link Audience} specific component.
+     * @param fallbackValue The fallback value used when this
+     *                      component has been serialized without
+     *                      being rendered.
+     * @return The virtual component
+     */
+    public static VirtualComponent receiverVirtualComponent(final Function<Audience, ComponentLike> apply, final String fallbackValue) {
+        return SpongeComponents.factory().receiverVirtualComponent(apply, fallbackValue);
     }
 
     private static Factory factory() {
@@ -151,6 +169,6 @@ Component render(
 
         ComponentFlattener flattener();
 
-        VirtualComponent receiverVirtualComponent(Function<Audience, ComponentLike> apply);
+        VirtualComponent receiverVirtualComponent(Function<Audience, ComponentLike> apply, String fallbackValue);
     }
 }